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ABSTRACT 


The  microprocessor  revolution  has  produced  a capable 
comouter  on  a single  printed  circuit  board. 

The  design  and  development  of  a real-time  operating 
system  for  a distributed  system  of  Single  Hoard  Computers  is 
presented  in  this  paper. 

There  are  user  manuals  and  oroqram  descriptions  tor  the 
operating  system#  a debug  module#  a CRT  module  and  a line 
printer  module. 

The  operating  system  has  been  developed  tor  a Multibus 
system  with  three  INTEL  Sinqle  Hoard  Computers  SBCS0/«?0-R 
and  o4K  bytes  of  common  memory. 

The  system  has  been  designed  specifically  for  Naval 
Tactical  Data  Systems  applications  and  the  feasibility  of 
such  applications  are  evaluated  with  respect  to  currently 
available  Single  Hoard  Computers  and  with  respect  to  Single 
Board  Computers  that  should  be  available  in  the  near  future. 


TABLE  OF  CONTI:  NTS 


I INTRODUCTION 


II  COMPUTING  REQUIREMENTS  FOR  NAVAL  TACTICAL  DATA 


SYSTEMS 


III  A COMPUTER  SYSTEM  USING  SINGLE  HOARD  COMPUTERS..  13 


A.  INTEL’S  SINGLE  BOARD  COMPUTER  SHCB0/20-4 


B.  SYSTEM  CONCEP! 


C.  SYSTEM  BUS  ORGANIZATION 


D.  MEMORY  ORGANIZATION 


E.  INPUT/OUTPUT  FACILITIES 


F.  INTERRUPT  STRUCTURE 


IV  A REAL-TIME  OPERATING  SYSTEM  FOR  SINGLE  BOARD 


COMPUTERS 


A.  SYSTEM  CUNCEPT 


B.  MODULAR  STRUCTURE 


C.  FACILITIES  OF  THE  OPERATING  SYSTEM 


?.  Communication  between  Modules 


3.  Time  Deoenoent  and  Periodic  Tasks 


Background  Tasks 


6.  Real-time  Clock  and  Count  Down  Clock 


D.  REAL-TIME  executive 


E.  INTERRUPT  HANDLING 


F.  SYSTEM  MONITOR 

G.  SYSTEM  INTEGRATION 

V AVAILABLE  USER  MOOULES 

A.  CRT  MODULE 

B.  LINE  PRINTER  MODULE 

C.  DEBUG  MODULE 

VI  CONCLUSIONS 

A.  HARDWARE  DESIGN 

1.  Standardization  and  Cost.. 

?.  Expandability... 

3.  Interface  with  Peripheral  Equipment.... 
U.  Maintenance  and  Rel i abi I i t y . • 

5.  Physical  Requirements.. 

6.  System  Redundancy 

B.  operating  SYSTEM 

I.  Naval  Tactical  Data  System  Requirements 
?.  Software  Deve I opment # M« | nt enance  and 

Extensions 

3.  Standardization 

<1.  Simulation.......... 

APPENDICES: 

A - Proqram  Description  for  Operating  System... 


B - User's  Manual  for  Operatinq  System 

C - User's  Manual  for  Debuq  Functions RS 

D • Program  Description  for  Debug  Module 108 

E « Program  Description  for  CRT  Modu 1 e ...........  1 3 


F - Program  Description  tor  Line  Printer  Module 


' 


1.  INTRODUCTION 


An  examination  ot  currently  installed  Naval  Tactical 
Data  Systems  reveals  that  the  heart  of  the  system*  the 
computer*  does  not  represent  today's  advanced  technology. 
Even  in  recently  implemented  systems  large  'space*  weiqht* 
power  and  maintenance  Cost  consuming'  second  generation 
computers  are  found.  The  use  of  second  generation  technology 
is  caused  by  lengthy  lead  times  in  systems  acquisition* 
system  conversion  and  especially  software  conversion  cost* 
educational  cost  etc.  however*  in  the  age  cf 
microcomputers*  which  provides  features  like  low  hardware 
cost*  high  degree  of  versatility  and  therefore  a potential 
for  st andardi tat i on  * high  reliability*  low  maintenance  cost 
and  low  power*  space  and  weight  consumption*  it  should  be 
the  time  to  develop  new  systems  in  order  to  make  use  of 
these  features  which  seem  to  be  tailored  specifically  for 
military  applications. 

Ihe  real-time  operating  system  developed  in  this  thesis 
should  be  understood  as  a step  in  the  direction  of  making 
us*  of  the  new  technology.  Ihe  operating  system  is  designed 
for  a distributed  system  ot  concurrently  operating  Single 
Board  Computers. 
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After  identifying  typical  co^out  inq  requirements  tor 
Naval  Tactical  Data  Systems*  a distributed  computer  system 
usinq  Sinqle  Hoard  Computers  and  a real-time  operatinq 
system  are  develooed.  Three  user  modules*  a debug*  CRT,  and 
a line  orinter  module,  are  introduced.  In  the  conclusion  of 
this  oaner  a comparison  between  the  identified  requirements 
and  the  developed  system  is  made  and  possible  extensions  are 
i ndi cated. 
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II.  COMPUTING  HtGUlfc’CMtNlS  FOR  NAVAL  TACTICAL  DAIA  SYSTEMS 


In  this  section  the  basic  requirements  tor  a computer 
system  which  is  to  drive  a Naval  Tactical  Data  System  are 
cons i dered. 

In  general  it  can  be  said  that  the  computer  svstem  has 
to  be  able  to  handle  the  workload  dictated  bv  the 
operational  specifications  ano  to  cooe  with  peak  situations 
without  a svstem  failure. 


Typically*  Naval  Tactical  Data  Systems  are  dedicated 
systems.  because  of  this  tact*  svstem  requirements  tor  the 
CPU#  memory  and  input/outout  are  known.  It  is  therefore  not 
necessary  to  carry  a vast  amount  of  overhead  in  order  to  be 
prepared  for  unknown  worst  cases.  However#  when  deciding  on 
a computer  svstem#  future  extensions  of  the  system  with 
hardware  consequences  should  be  taken  into  account. 
Un tor t unat e l y it  is  very  difficult  to  predict  the  possible 
enhancements  durina  the  life  time  of  a Naval  Tactical  Data 
System.  Therefore#  the  chosen  computer  system  should  be 
exrandab l e . 


Since  Naval  Tactical  Data  Svstems  are  rather  complex 
systems  with  many  different  svstem  functions*  the  equipment 
used  in  an  i mp l ement at i on  is  produced  bv  many  different 
menu f ac t urers . Although  there  are  some  standard  interfaces 
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♦or  Naval  Tactical  Data  System,  the  computer,  which  is  to 
drive  the  Peripheral  hardware  has  to  be  versatile  in  oroer 
to  t>e  connected  to  different  devices  with  different 
interfaces. 


In  order  to  reduce  cost  by  large  series  and  simplified 
maintenance  a standarditat ion  between  different  systems  is 
h i qh 1 y desirable. 

The  instruction  repertoire  of  the  computer  svstem  has 
to  provide  instructions  which  allow  the  efficient 
proaramminq  of  typical  operations  in  Naval  Tactical  Data 
Systems.  Typical  operations  are 


- the  solution  of  complex  mathematical  problems 
in  a reasonable  time  (quasi  real-time) 

- bit  man i pu 1 at i ons 

- fast  data  base  access 

- complex  and  fast  mout/outout  operations 

- extensive  interrupt  handling. 

M,my  command  and  control  operations  and  decisions 
depend  on  the  orooer  functioning  of  the  Naval  Tactical  Data 
Svstem.  High  reliability,  even  under  extreme  physical 
conditions,  are  therefore  a too  requirement  for  this  Hind  of 
system.  In  case  of  a breakdown,  the  tactical  information 
often  is  lost  or  it  takes  some  time  to  recreate  a valid 
tactical  situation.  Hecause  of  the  importance  of  the  Naval 
Tactical  Data  System  within  a larger  system  (ship  or 


aircraft)#  a complete  back-up  for  the  computer  system  is 
desirable. 


The  major  requirement  to  be  met  by  the  operating  system 
is  to  run  the  system  under  real-time  conditions.  Dependant 
on  the  computer  system#  this  leads  to  operating  systems  of 
differing  sizes  where  the  ratio  cf  time  used  by  the 
operating  system  to  total  time  should  be  optimized. 


Basically#  the  operating  system  has  to  support  an 
overall  program  structure  which  simplifies 

- software  development 

- software  maintenance 

- software  extensions 

- use  of  components  from  other  systems 
(standardization). 
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III.  A COMPUTER  SYSTEM  USING  SINGLE  BO AMD  COMPUTERS 

In  this  section  the  hardware  conceot  of  a computer 
system  consisting  of  Sinqle  Board  Computers  is  developed. 
Basic  buildinq  block  of  this  computer  system  is  a INTEL 
Single  Board  Computer.  SRC80/20-4. 

A.  INTEL’S  SINGLE  HOARD  COMPUTER  SHCBO/aO-4 

INTEL'S  Single  board  Computer#  SHC80/<?0-4,  represents  a 
complete  microcomputer  on  a single  printed  circuit  board. 

The  SHC80/£0-4  includes: 

- 8080 A CPU 

• 4K  static  Random  Access  Memory  (RAM) 

• up  to  8K  Read  Only  Memory  (ROM) 

- 48  proarammable  parallel  input/output  lines 

- a programmable  serial  input/output  interface 

V - programmable  interval  timers 

• programmable#  eight  priority  level#  vectored 
interrupt  structure 

- bus  interface  for  enternal  system  bus. 

An  in-depth  description  of  hardware#  function  and 
programming  of  the  SBC80/20-4  is  qiven  in  the  SBC80  manual 
(INTEL  SBC 80 /^0  HARDWARE  REFERENCE  MANUAL  R8-3l7c). 
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t.  8080A  CPU 

The  8080  A is  a single  LSI  chip  CPU.  It  has  six 
8-t*it  General  purpose  registers  and  an  accumulator.  The  six 
General  purpose  registers  mav  he  addressed  individually  or 
as  reoister  pairs,  providing  In-bit  operations. 

A lo-bit  stack  pointer  controls  the  addressing  of  an 
external  stack  which  can  be  located  in  general  memory. 

The  H080A  has  an  address  range  of  bUK  bytes. 

The  CPU  Set  consists  of  the  8080A  CPU. clock 
generator  and  a system  controller.  It  performs  all  system 
processing  functions  and  provides  a stable  timing  reference 
for  all  other  circuitry  on  the  board. 

P.  Random  Access  Memory/Head  Only  Memory 

The  <4  K Random  Access  Memory  on  the  Single  Board 
Computer  can  be  jumper  assigned  to  the  top  address  space  in 
any  one  of  the  four  IbK  address  blocks. 

The  Read  Only  Memory  is  located  starting  at  address 
0000  and  has  a site  of  4K  or  8K  depending  on  the  type  of  me* 
mory  devices  used. 

The  full  CPU  capability  of  addressing  bUh  bytes  can 
be  utilited  by  adding  externa)  memory  boards  which  are 
accessible  via  the  system  bus.  The  respective  parts  in  this 
memory  are  'shadowed*  by  the  on-board  memory.  The  CPU  set 
is  capable  of  determining  whether  an  addressed 
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memory  location  is  on-board  or  not* 

i.  Parallel  Input/Uutout 

The  SBC  proviaes  48  input/output  lines  which  can  be 
configured  by  software  in  combinations  of  un i -d i rec t i ona l or 
bi-directional  input/outout  ports. 

4.  Serial  Input/GutPut 

The  SHC  includes  a programmable 

synchronous/asynchronous  RS2J2C  communication  interface 
which  is  capable  of  operating  with  all  common  commun i cat i on 
f requenc i es . 

5.  Interval  Timers 

The  SBC  contains  two  fully  programmable  and 
independent  BCD  or  16-bit  binary  interval  timers/event 
counters . 

6.  Interrupt  Structure 

' i 

The  on-board  interrupt  controller  provides  vectoring  J 

for  up  to  eight  interrupt  leves  in  four  different  priority 
processing  modes*  Operating  mode  and  priority  assignment 

' 1 

are  under  software  control. 

7.  System  Hus  Interface 

This  interface  is  compatible  with  INTEL'S  Multibus 
system  and  allows  the  combination  of  several  Single  Board 


Comput  ers , memory  and  other  utility  boards  on  one  system  bus 


Two  bus  priority  systems  ere  available:  serial  (up 
to  three  master  controller)  and  parallel  (uo  to  sixteen 
master  controller), 

H.  SYSTtM  CONCtPI 

The  development  of  a computer  system  consisting  itself 
of  rather  independent  Sinale  Board  Computers  automatically 
leads  to  the  concept  of  a distributed  system.  A distributed 
system  in  this  context  is  a computer  system  in  which  seve- 
ral orocessors  are  working  on  more  or  * 'ss  independent  tasks 
connected  by  a common  system  bus.  The  computer  system  to  be 
developed  is  a direct  realization  of  this  concept. 

Basically  the  system  consists  of  Sinqle  Board  Computers 
and  h^K  bytes  of  Random  Access  Memory  externa)  to  the  Single 
Board  Computers.  The  external  memory  resides  on  four  printed 
circuit  boards  which  are  bus  compatible  with  the  Sinqle 
Board  Computers.  This  memory  represents  a common  memory  to 
all  Single  Board  Computers  attached  to  the  same  bus.  This 
concept  in  connection  with  the  on-board  memory  of  the  Single 
Board  Computers  opens  up  software  Possibilities  which  are 
explored  in  Chapter  Iv, 

Information  interchange  between  Single  Hoard  Computers 
can  be  realized  using  three  different  concepts. 


Concept  ( t ) : 

Storage  of  information  in  common  memory  and  periodic 
checks  of  the  agreed  upon  'mail  boxes'.  This 
concept  can  be  used  in  systems  where  all  processing 
is  organized  in  a hierarchical  'producer  - consumer' 
structure.  In  this  structure  basic  processing  is 
local  to  a Single  Board  Computer.  Data  is  gathered 
and  processed  at  a high  rate.  The  output#  reduced 
data  and  upaates  of  common  data  bases#  is  required 
by  others  processors  at  a lower  frequency.  Since 
external  events  can  occur  asyncronous 1 y # an  extra 
data  path  through  common  memory  for  such  messages 
has  to  be  provided. 

Concept  ( 2 ) : 

Storage  of  information  in  common  memory  and 
interruption  of  the  information  receiving  Single 
Board  Computer.  The  addition  of  interrupts  to 
concept  (1)  allows  both  synchronous  and  asynchronous 
transfers  of  data  sets  between  Single  Board 
Computers.  The  disadvantage  of  this  concept  is  the 
number  of  interrupt  lines  required  with  an 
increasing  number  of  Participating  Single  Board 
Computers  in  order  to  address  each  other.  The 
alternative  of  havinq  only  one  interrupt  common  to 
all  Sinqle  Board  Computers  would  ’ cause  an 
interruption  of  all  processors  and  requires  a 
polling  scheme  to  determine  the  receiving  Single 
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Direct  transfer  of  information  between  Sinate  board 
Computers  usino  inout/outout  ports  and  interrupts. 
This  concept  can  be  used  to  exchange  time  critical 
information  between  processors.  Since  it  directly 
involves  the  CPU  of  both  the  sender  and  receiver  the 
amount  of  data  passed  has  to  be  kept  small. 
However,  larae  data  sets  can  be  transferred  with  the 
use  of  pointers  to  common  memory.  The  limitations 
of  concept  (2).  extended  tor  data  lines  between 
input/output  ports,  also  apply  tor  concept  (5). 


The  input/output  structure  of  the  Sinqle  board  Computers' 
allow  the  connection  of  a variety  of  peripheral  devices  to 
the  computer  system.  Each  connection  represents  a hardware 
modification  or  specialization  of  a Single  Board  Computer, 
i.e.  the  dedication  of  a part  of  the  computer  system  to  a 
special  task. 


C.  SYSTEM  BUS  ORGANIZATION 


The  system  bus.  which  is  the  main  communication  line 
between  several  Single  Board  Computers,  common  memory  and 
other  utility  printed  circuit  boards,  is  implemented  usinq 
INTEL'S  Multibus.  This  bus  system  allows  master-master  and 
master-slave  relationships  between  various  system  hardware 
modu I es . 


Sf/fr--  ' 


Transfers  via  this  bus  oroceed  asynchronously#  i .e.  the 
transfer  speed  is  dependent  on  the  soeed  of  the  transmitting 
and  receiving  devices*  Once  a module  has  gained  control  of 
the  bus#  transfers  can  oroceed  with  a maximum  rate  of  5 
million  by tes/second. 

Master  modules  can  qain  access  to  the  bus  using  a serial 
or  parallel  priority  resolving  scheme.  The  serial  scheme  is 
limited  to  three  masters  because  of  the  signal  propagation 
delay#  but  uo  to  sixteen  masters  may  be  connected  to  the  bus 
using  the  parallel  priority  scheme. 

The  bus  system  provides  an  override  facility  which 
allows  a hardware  module  to  keep  control  of  the  bus  until 
the  operation  is  completed.  This  feature  can  be  used  under 
software  control. 

0.  MEMORY  ORGANIZATION 

The  total  memory  of  the  computer  system  consists  of 

- common  Random  Access  Memory 

- on-board  Random  Access  Memory 

- on-board  Read  Only  Memory. 

The  on-board  Random  Access  Memory  portions  are  located 
in  the  same  region  on  all  Single  Hoard  Computers.  This 
leaves  the  respective  portion  in  common  memory  unused# 
however#  it  is  now  possible  to  run  identical  programs  on  the 
Single  Hoard  Computers.  Identical  programs  allow  the  access 
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INPUT/OUTPUI  F AC IL  I I IkS 


Each  Single  Hoard  Computer  provides  serial  and  parallel 
input/output  facilities  which  can  be  completely  driven  by 
interrupts. 

The  serial  interface  is  ready  to  be  used  with  a CUT. 
with  the  addition  of  an  adapter  a TTY  can  also  be  connected 
to  a Sinqle  Board  Computer. 

Each  Single  Board  Computer  provides  si*  bi-directional 
8-bit  ports. These  ports  can  be  configured  by  software  to  be 
8-bit  data  input/output  ports  or  <l-bit  bit  addressable 
inout/output  ports.  The  latter  can  be  used  to  receive  and 
send  status  bit  information  in  conjunction  with  the  8-bit 
input/output  ports. 

The  hardware  provides  three  basic  modes  of  operation 
that  can  be  selected  by  software: 

- Mode  0 : Basic  Input/Output 

- Mode  1 : Strobed  Input/Output 

- Mode  2 : Bi-directional  Bus 

Mode  0 can  be  used  for  simple*  status  driven  device 
interfaces.  Since  this  kind  of  interface  is  not  compatible 
with  the  real-time  reouirements  it  is  not  considered  here. 

Mode  l and  Mode  i generally  require  the  support  of 
interrupts.  Mode  1 provides  a means  for  transferring  data 
to  or  from  a specific  port  in  conjunction  with  strobe  or 


•hand-shake'  signals.  This  mode  can  he  used  for  a variety  of 


different  peripheral  devices. 

Mode  2 provides  communicat ion  with  a peripheral  device 
on  a fl-bit  bus  tor  noth  receiving  and  transmitting  data. 
•Hano-shake'  are  provided  to  maintain  proper  bus  flow  in  a 
similar  manner  to  Mode  I. 

The  dr i ver/t erm i nat i on  connections  of  the  parallel 
input/output  section  are  left  open  ana  have  to  be  inserted 
depending  on  the  actual  implementation. 

The  primary  user  considerations  in  determining  how  to 
use  each  of  the  six  innut/output  ports  are: 

- choice  of  operating  mode 

- direction  of  data  flow 

- choice  of  dr i ver/t erm i nat or  netwr’ks 

- jumper  conf igurat ions 

- mutual  port  restrictions. 

F.  INTERRUPT  STRUCTURE 

The  interrupt  controller  accents  jumper  selectable 
interrupt  requests  from 

- parallel  input/output 

- serial  innut/outnut 

- interval  t imers 

- system  bus 
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• directly  from  e*trrr>4l  devices. 

The  controller  resolves  priority  among  the  eight 
possible  interrupt  levels  according  to  an  algorithm  which  is 
selectaPle  by  software.  The  priority  ass i gnment s and 
algorithms  can  be  changed  dynamically  at  any  time  during 
system  operation. 

Of  the  four  possible  interrupt  modes  only  the  'fully 
nested'  mode  is  considered  here.  In  this  mode  priorities  are 
lived  such  that  level  0 has  the  hiahest  priority  and  level  7 
the  lowest. 

The  interrupt  hardware  provides  vectored  interrupts 
where  the  interrupt  vector  is  not  lived  in  its  location  and 
si/e  (<l  or  8 bytes/interruot  ).  The  interrupt  controller  has 
to  be  programmed  with  location  and  step  width  ot  the 
interrupt  vector. 

The  interrupt  controller  allows  the  setting  ol  a one 
byte  interrupt  mask  by  soltware.  Ihis  feature  allows  the 
inhibition  of  not  wanted  interrupts  in  any  combination  ol 
the  eight  interrupt  levels. 


25 


( 

IV.  A KtAL-TIMt  OPE  WAT  1 NG  SYSTE*  f U«  SINGLE  HO AMO  COMPuItKS 


lhe  objectives  tor  the  operation  system  to  be  developed 
in  this  sec  t i on  are  5 

1)  The  operatinq  system  has  to  be  able  to  control  NTDS 
applications  under  real-time  conditions. 

2)  The  host  computer  system  is  the  multi  processor 
microcomputer  system  oescribed  in  the  previous  section. 

J)  The  existinq  P i c rocomout er  Development  System  and 
the  associated  support  software  ( IS  I S- I I » PL /M-80 ) has  to  be 
used  for  program  development. 

<1 ) The  operatinq  system  must  provide  debuqqinq  tools 
that  allow  system  debuqaina  and  system  testing  under  real- 
t i me  condi t i ons . 

This  chapter  describes  the  ooeratinq  system  in  more 
aeneral  terms.  An  in-deoth  description  is  given  in  the 
user's  manual  (Appendix  A)  and  in  the  program  description  of 
the  operating  system  (Appendix  B). 

A TASK  is  a part  of  the  Program  which  handles  a 
specific  function  of  the  system  and  consists  of  one  or  more 
procedures . 
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A MODULfc  is  a separate  task  or  separate  group  of 


related  tasks  which  are  considered  to  oe  independent  in 
terms  of  software  development  and  system  integration. 

The  EXECUTIVE  is  the  kernel  of  the  operating  system  and 
controls  the  scheduling  and  execution  of  tasks. 


The  OPERATING  SYSTEM  consists  of  executive#  system 
calls  and  system  data. 

A.  SYSTEM  CONCEPT 

In  contrast  to  an  operating  system  for  general  usage  in 
which  the  nature  of  the  runninq  tasks  is  not  predictable 
this  rea 1 • t i me  operating  system  drives  a dedicated  system. 
Dedicated#  in  this  context#  means  thr,t  the  implemented  tasks 
do  not  chanqe  at  run  time  of  the  system.  This  concept  allows 
dropping  much  of  the  book-keeping  overhead  which  is  typical 
for  operating  svstems  for  general  usage.  Tasks  in  this 
system  are  not  phvsicallv  moved  in  memory,  thev  are  only 
activated  and  suspended. 

Execution  of  tasks  is  under  control  of  the  Kernel  of  the 
operating  system,  the  executive.  The  executive  controls  the 
CPU  assignment  to  the  various  tasks  activated  by  interrupts# 
to  process  a message  from  another  task  or  at  a preset  point 
in  time. 


L 


H 


MODULAR  STRUCTURE 


The  operating  system  supports  a strictly  modular  program 
structure.  Modules  are  integral  parts  of  the  overall  proqram 
which  usually  handle  a specific  function  or  a group  of 
related  functions.  This  organization  not  only  eases  program 
development  and  maintenace*  it  also  allows  easy-to-i mp I ement 
chanqcs  of  the  system.  Typically.  a module  i9  compiled 
separately  and  then  intearated  into  the  rest  of  the  system. 
Because  of  the  independent  nature  of  modules  they  can  be 
removed  or  replaced  without  influencing  the  remaining 
system.  Not  only  user  programs  represent  modules,  the 
operating  system  itself  consists  of  independent  modules. 

Modules  are  identified  t>v  a number.  The  number  depends 
on  the  number  of  the  Single  Hoard  Computer  which  hosts  the 
module.  Maximum  number  of  modules  oer  Single  Board  Computer 
is  8.  Modules  in  Single  Board  Computer  1 have  numbers  0 to 
7.  in  Single  Board  Computer  2 numbers  8 to  15  etc.  The 
lowest  module  number  in  a Single  Board  Computer  is  reserved 
for  the  executive  of  the  operating  system  while  the  highest 
number  represents  the  debug  module. 

C.  FACILITIES  OF  THE  OPERATING  SYSTEM 

1.  Priority  Tasks 

Priority  tasks  represent  the  highest  priority  level 
a task  can  have  in  the  system.  Priority  tasks  are  executed 
as  soon  as  processor  control  is  returned  from  the  current 
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active  task 


A priority  task  has  to  be  entered  into  the  list  of 
priority  tasks  with  a system  call.  A single  execution  of 
that  priority  task  can  then  be  scheduled  with  another  system 
call. 


The  primary  purpose  of  priority  calls  is  the  process 
of  interrupts.  The  call  of  the  priority  task  has  to  be 
scheduled  in  the  interrupt  service  routine.  The  high 
priority  of  that  task  ensures  that  it  is  executed  as  soon  as 
the  processor  becomes  available. 

<?.  Communication  between  Modules 

Since  modules  are  separate  and  independent  parts  of 
the  system  the  operating  system  has  to  provide  a function 
which  allows  the  tasks  or  modules  to  communicate  with  each 
other.  This  communication  uses  the  form  of  messages  which 
are  sent  from  one  module  to  another.  A message  is  sent  with 
a system  call  and  entered  into  a FIFO  list.  The  receiving 
module's  message  entry  is  called  if  no  priority  task  is 
pending  and  the  message  is  to  be  processed  next  in  the  FIFO 
list. 

A message  consists  of  message  control  block  and 
possibly  data  bytes.  The  message  control  block  identifies 
receiving  module*  sending  module*  message  number  and  length 
of  the  message.  The  message  number  depends  entirely  on  an 
agreement  between  sending  and  receiving  module  and  serves 
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the  Purpose  of  identifying  the  message.  If  the  message 
control  block  itself  is  not  sufficient  for  the  transmission 
of  information#  data  bytes  can  be  added  to  the  messaqe. 

A message  is  always  sent  from  one  module  to  another 
module  regardless  in  which  Sinqle  Board  Computer  they 
reside.  The  operatinq  system  decodes  the  number  of  the 
receiving  module  and  routes  the  message  to  another  Sinqle 
Board  Computer  if  necessary. 

3.  Time  Dependent  and  Periodic  Tasks 

Real-time  environments  and  especially  Naval  Tactical 
Data  Systems  require  the  execution  of  certain  tasks  at  a 
predefined  point  in  time  or  Periodically  with  a specified 
time  interval.  In  this  operatinq  system  these  tasks  range 
in  the  priority  hierarchy  below  the  priority  tasks  and  the 
process  of  messages. 

Periodic  tasks  have  to  be  identified  to  the 
operating  system  with  a system  call,  with  this  system  call 
the  task  and  the  specified  time  interval  is  entered  into  the 
list  of  periodic  tasks.  The  executive  uses  the  system's 
real-time  clock  to  determine  the  exact  time  of  the  call.  A 
periodic  task  can  be  suspended  or  the  specified  time 
interval  can  be  changed  with  system  calls. 


Background  Tasks 


Background  tasks  represent  the  lowest  priority  level 
in  the  system.  They  are  executed  only  if  no  priority  task 
is  pending*  no  message  is  to  be  processed  and  no  periodic 
call  is  necessary*  i.e.  the  processor  is  idling,  this  idle 
time  can  be  used  to  perform  hardware  Checks  on  a time  slice 
basis  or  to  perform  data  reductions  for  statistic  and  test 
purposes . 


If  a Single  Board  Computer  is  completely  interrupt 
driven*  (i.e.  not  periodically  activated)  the  processor  can 
enter  the  HALT  state  to  free  the  system  bus.  The  next 
interrupt  will  'awake*  the  processor  and  the  executive. 

5.  System  Calls 

The  operating  system  provides  system  calls  for  task 
management*  communication  between  modules  and  functions 
which  are  commonly  used  by  several  modules. 

i 

6.  Real-time  Clock  and  Count  Down  Clock 

l 

The  operating  system  provides  two  different  clocks* 
a continuously  running  real-time  clock  and  a count  down 
clock  which  can  be  started  with  a specified  run  time.  There 
is  only  one  real-time  clock  in  common  memory  which  is  used 
by  all  Single  Board  Computers  in  the  system.  The  real-time 
clock  is  driven  by  the  Single  Board  Computer  with  the  number 
1.  Both  real-time  clock  and  count  down  clock  make  use  of 


Each  Single  doaro  Computer  runs  its  own* 
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executive.  An  executive  is  tailored  to  its  environment  with 
special  compile  parameters. 

The  executives  in  different  Single  Hoard  Computers 
communicate  with  each  other  using  normal  messages  via  an 
exchanqe  in  an  absolutely  located  buffer  in  common  memory. 

Because  the  code  of  the  executive  is  executed  most  often 
it  is  located  in  on-board  memory. 

E.  INTEWHUPT  HANDLING 

All  interrupts  are  handled  entirely  by  the  operating 
system.  The  operating  system  initialises  the  interrupt 
controller  and  sets  up  the  interrupt  vector. 

There  are  four  special  interrupts  which  are  handled  by 
the  operating  system:  real-time  clock  interrupt*  count  down 
clock  interrupt*  system  restart  interrupt  and  an  interrupt 
which  causes  the  system  to  enter  the  monitor*  if 
impl emented. 

User  modules  can  activate  interrupts  with  a system  call 
and  passing  the  requested  interrupt  level  and  the  index  of  a 
priority  task  to  process  the  interrupt.  In  case  of  an 
interrupt*  a call  of  the  priority  task  is  scheduled  by  the 
operating  system.  The  de-activation  of  an  interrupt  is  also 
performed  with  a system  call. 
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F.  SYSTEM  MONITOR 

The  system  monitor  is  implemented  as  a system  call.  It 
is  called  when  internal  program  limits  are  exceeded.  An 
address  value  and  two  byte  values  are  passed  with  the  system 
call.  The  address  can  point  to  the  location  of  the  error 
and  the  two  byte  values  can  further  specify  the  nature  of 
the  error. 

The  system  monitor  generates  the  display  of  an 
appropriate  messaqe  for  the  operator. 

This  feature  is  primarily  designed  as  an  aide  in  the 
proqram  development  and  test  phase  and  to  cover  undefined 
orogram  states. 

G.  SYSTEM  IN  I EGRAT ION 

User  modules  to  run  under  the  operating  system  are 
independent  with  respect  to  other  user  modules  and  the 
OPeratina  system.  In  order  to  provide  the  necessary  links 
to  the  operating  system*  a user  module  needs  to  be  compiled 
together  with  some  system  data  and  externa)  declarations  of 
the  system  calls.  Furthermore  the  module's  entry  for  the 
process  of  messages  has  to  be  identified  to  the  operating 
system. 

The  linking  of  a module  to  the  operating  system  is 
implemented  using  the  pub  I i c /ex t erna 1 declaration  feature  of 
PL/M-80  and  the  LINK  program  in  ISIS~II. 
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Oeoending  on  the  application#  the  linked  and  located 
code  can  be  kept  eiternally  and  loaded  into  Random  Access 
Memory  or  transferred  into  trasaMe  and  Programmab I e Read 
Only  Memory. 
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V.  AVAILABLE  USER  MODULES 


Three  user  modules  have  been  develooed  and  are 
available  to  run  in  the  presented  system  configuration:  a 
CRT  module*  a line  printer  module  and  a debuq  module.  The 
software  documentation*  a program  description  of  each  module 
and  a user's  manual  for  the  debuQ  functions*  is  part  of  the 
Apoendi » . 

A.  CUT  MODULE 

This  module  is  a typical  user  module.  It  drives  a CRT 
connected  to  a Single  Board  Computer.  The  CRT,  via  the  CHT 
module*  may  be  used  by  any  other  module  in  the  system* 
regardless  in  which  Sinqle  Board  Computer  it  is  located. 
Messaqes  are  used  for  the  communication  between  the  CRT 
module  and  a 'CRT  user'  module. 

The  CRT  module  provides  two  different  kinds  of  outputs 
to  the  CRI  and  the  facility  of  obtaining  inputs  from  the 
connected  keyboard. 
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B.  LINE  PRINTER  MODULE 

The  line  printer  module  is  the  driver  for  a line 
printer.  Any  module  in  the  system  can  transfer  te»t  with  a 
message  to  the  line  printer  module  in  order  to  have  it 
printed. 

C.  DEBUG  MODULE 

This  module  allows  the  (lebuqgirig  of  the  entire  system 
unoer  real-time  conditions*  i.e.  without  influencing  system 
operation  during  the  debugging  process.  The  provided  debug 
functions  are  designed  to  ease  debugging  of  malfunctions 
which  are  typically  encountered  in  real-time  Systems  and 
specifically  in  Naval  Tactical  Data  Systems. 

The  debugging  concept  allows  several  users  to  debug 
different  program  parts  at  the  same  time. Any  Single  Board 
Computer  can  be  debugged  from  any  other  Single  Board 
Computer  with  the  restriction  that  only  one  user  is  allowed 
to  debug  a Single  Board  Computer  at  a time. 

Inout/output  media  for  the  debug  module  are  a CRT  or 
equivalent  device  ano  a high  speed  printer  for  output  only. 
Both  devices  are  driven  by  modules  described  in  previous 
sec  t i ons . 
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In  this  section  a comparison  is  made  between  the 
proposed  computer  system  (hardware  concept  and  operating 
system)  and  the  reouirements  established  in  Chapter  11. 

It  is  emphasized  that  no  attempt  is  made  to  examine  the 
capabilities  of  the  previously  described  computer  system  to 
drive  a typical  Naval  Tactical  Data  System.  Obviously  the 
CPU,  INTEL'S  808QA,  fails  to  quality  for  this  task  because 
of  its  restricted  instruction  repertoire  (especially  the 
lack  of  arithmetic  instructions),  eiqht  bit  word  size  and 
64K  byte  address  space. 

with  the  recent  introduction  of  a single  chip  16-bit 
microprocessor  with 

- instructions  to  operate  on  8-, 16-  ana  5?  bit 
quant i t i es 

- signed  and  unsigned  arithmetic  operations 
includinq  multiplications  and  divisions 

- address  space  of  1 meoabvte 

the  proposed  model  with  minor  adaptive  changes  in  the 
operatinq  system  becomes  realistic,  provided  that  the 
concept  of  Singl"  Board  Computers  will  be  keot.  Considering 
the  success  of  INiEL's  SBC80  series, 'this  is  very  likely. 
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A.  HAWDwAWE  DESIGN 


1.  St andardi zat i on  and  Cost 

The  proposed  hardware  design#  distributed  system 

with  Sinqle  board  Computers  on  a common  bus  system,  is  very 
flexible.  It  can  be  used  in  Naval  Tactical  Data  System 
applications  which  recuire  extensive  computing  power  as  well 
as  in  very  small  ana  simple  systems.  because  of  this 

flexibility,  the  proposed  concept  would  reduce  the  number  of 
different  computer  architectures  currently  in  use.  This 
reduction  is  equivalent  to  an  increase  in  standardization 
which  besides  lower  hardware  cost  has  a strong  influence  on 
cost  in  terms  of  software  development,  maintenance  and 
training  of  personnel. 

2 . Exoandab i 1 i t y 

The  proposed  concept  has  special  advantages  as  far 
as  future  changes  or  extensions  of  the  system  are  concerned. 

A hardware  change  is  kept  local  to  one  or  a few  Single  board 

Computers.  Extensions  are  accomplished  easily  by  adding 
Single  board  Computers'  to  the  system.  However,  it  should  be 
noted  that  the  utilization  of  the  system  bus  may  turn  out  to 
be  the  'bottleneck’  of  such  a system.  The  capacity  of  the 
system  bus  clearly  dictates  the  limits  for  the  proposed 
computer  desiqn. 

A solution  to  this  problem  is  thinkable  in  form  of  a 
'super  bus'  structure  consistina  of  two  or  more  of  the 
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previously  developed  sysfe^s  and  a connecting  'super'  bus 
system.  This  structure  would  lead  to  a strictly  hierarchical 
system  concept  in  which  information  is  reduced  before  being 
transferred  to  the  next  hiaher  bus  level. 

3.  Interfaces  with  Peripheral  Equipment 

The  implemented  input/output  interfaces  in  Single 
Board  Computers  are  not  fixed.  The  input/outout  and 
interrupt  controller  are  software  programmable  and<  in 
connection  with  easy  to  implement  jumper  connections*  allow 
the  tailoring  of  the  input/output  and  interrupt  facilities 
according  to  the  application. 

<1.  Maintenance  and  Reliability 

The  most  astonishing  effects  of  the  new  technology 
used  in  Single  Board  Computers  can  be  found  in  the  area  of 
maintenance  and  reliability.  A computer  system  consisting  of 
Single  Board  Computers  is  practically  ma i n t enance* f ree  . 

Although  reliability  tests  of  the  new  technology  are  still 
in  progress*  it  is  already  known  that  there  is  a great 
increase  in  reliability.  In  case  of  a failure  parts  of  the 
computer  would  no  longer  be  replaced:  the  computer  would  be 
reo laced  itself. 

\ 

5.  Physical  Requirements 

The  proposed  computer  system  drastically  reduces 
weight*  soace  and  environmental  (power*  cooling  etc.) 
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requirements  of  currently  implemented  Naval  Tactical  Data 
Systems.  This  reduction  is  especially  important  for  air- 
borne systems. 

6.  System  Redundancy 

Up  to  now  a complete  back-up  computer  system  is  not 
found  in  Naval  Tactical  Data  System  applications.  Reasons 
for  this  are  mainly  costs  and  sometimes  space  and  weight, 
with  an  i mp 1 emen t a t i on  of  the  proposed  system  concept  these 
constraints  could  be  eliminated.  Although  reliability  is 
already  greatly  increased  a redundant  system  design  can  be 
considered. 

B.  OPERA  1 I NG  SYSTEM 

l.  Naval  Tactical  Data  System  Requirements 

The  proposed  operating  system  has  been  designed 
specifically  for  an  application  in  Naval  Tactical  Data 
Systems.  It  provides  facilities  which  ensure  the  real-time 
operation  of  the  entire  system.  'Real-time'  is  a relative 
noression  with  respect  to  Naval  Tactical  Data  Systems.  An 
operator  expects  a system  reaction  in  real-time  after 
completion  of  his  inputs.  In  this  case  the  system  has  to 
provide  an  ' i nstantenous ' reaction  in  terms  of  human  speed. 
However*  in  the  case  of  a high  frequency  radar  interface* 
' i nst antenous ' represents  a considerably  shorter  time 
between  input  and  reaction.  The  structure  of  the  operating 


system  with  different  priority  levels  supports  this 
interpretation  of  'real-time'  as  well  as  other  commonly 
found  Naval  Tactical  Data  System  operations. 

<?.  Software  Development  Maintenance  and  Extensions 

Because  of  the  modular  structure  supported  by  the 
operating  system*  it  is  possible  to  run  test  vehicles  early 
in  the  program  development  phase.  The  modules  in  the  test 
vehicle  are  replaced  by  the  original  modules  as  soon  as  they 
are  completed  or  the  simulated  equipment  is  installed.  This 
concept  of  a continuous  test  of  the  qrowinq  system  involves 
some  simulation  overhead  but  it  avoids  'biq  bang'  tests  and 
leads  to  a better  tested  system. 

The  modular  structure  also  eases  program 
maintenance*  because  modules  are  easily  changed  and  re- 
integrated into  the  system. 

Extensions  to  the  system  are  implemented  by  adding 
modules.  Hardware  facilities  of  the  computer  system  can  be 
extended  by  increasing  the  number  of  Single  Board  Computers. 
In  order  to  find  an  optimal  distribution  of  the  extended 
program  it  may  be  necessary  to  re-distribute  the  modules 
over  the  Sinqle  Board  Computers. 

3.  St andardi ?at i on 

The  structure  of  the  operatinq  system  basically 
reflects  a similar  structure  used  in  various  real-time  Naval 
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Tactical  Data  Systems.  This  allows  the  use  of  already 

developed  software  ana  knowledge. 

' 1 it 


'4.  Simulation 


Simulation  in  Naval  Tactical  Data  Systems 


i s 


needed 


mainly  for  three  reasons:  software  development*  software 
test  and  operator  training.  The  modular  software  structure 
in  connection  with  the  distributed  Single  Board  Computer 
concept  allow  simulation  not  only  of  missing  modules  or 
equipment*  it  allows  the  simulation  of  the  operation  of 
entire  Sinqle  Board  Computers  as  well.  No  hardware  changes 
are  necessary  since  the  simulation  takes  place  entirely 
inside  the  computer  system. 


at 


TABLE  OF  CONTENTS 


t General 3 

1.1  lnt roduct ion. . , . . . . . i 

1.2  Abbreviations  and  Conventions 5 

2 Executive a 

2. 1 Inputs « 

2.2  Function............... <1 

2.2.1  System  Ini t i al i zat i on <4 

2.2.2  Priority  Calls 5 

2.2.3  Communication  between  Modules 5 

2.2.3. 1 Internal 6 

2. 2.3. 2 External ...» 6 

2.2.4  Periodic  Calls 7 

2.2.5  Background  Tasks 7 

2.2.6  Message  Extraction 7 

2.3  Output  B 

3 Interruot  Handling 8 

4 System  Data 4 

5 System  Calls....... 10 

6 Weal-time  Clock  ana  Count  Down  Clock 11 

7 Loader 12 


- I 


43 


Memory  Man..* 

Absolute  Oata. 

Absolute  code.... 

Changes  of  SBC  Monitor... 

Listing  of  Executive  Data 


l 


I 


* . 1 Int  roduc  t i on 


This  segment  of  text  describes  the  function  of  the  operating 
system.  The  use  of  the  facilities  is  documented  in  the  user's 
manual  for  the  operation  system. 

In  cases  where  system  functions  are  well  explained  in  the 
program  listing  itself  no  cescription  is  given  here. 

The  executive  is  considerea  to  be  a module.  It  has  the  lowest 
possible  module  number  in  a SBC  and  the  module  identification 
EX. 


1.2  Abbreviations  and  Conventions 

All  numbers  in  this  segment  of  text  are  decimal  except  as 
otherwise  indicated. 

Task  - part  of  the  proqram  which  handles  a specific 

function  of  the  system  and  consists  of  one  or 
more  procedures 

Module  - part  of  the  program  which  consists  of  one  or  more 
(related)  tasks  and  can  be  compiled  separately 

Executive  * part  of  the  operating  system  which  controls  the 
scheduling  and  execution  of  tasks 

Ooerat i ng 

System  - consists  of  executive#  system  calls  and  system  data 

System  - consists  of  operating  system  and  all  integrated 

user  modules 

SBC  - Single  Board  Computer 

MOS  - Microcomputer  Development  System  (INTEL) 

MCB  - Message  Control  Block 
RMN  - Receiving  Module  Number 
SMN  - Sending  Module  Number 
MN  « Message  Number 
ML  • Message  Length 

EX  - executive#  modu1 

LP  • line  printer  mTdule#modu' 

CS  • CRT  module#  modu! 

DB  • debug  module#  modu! 

RTC  - Real  Time  Clock 
COC  - Count  Down  Clocx 


numbe  r 

i n 

SBC 

1/2/3 

• 

• 

00/08/16 

number 

i n 

SBC 

1/2/3 

• 

• 

OS/13/21 

number 

i n 

SBC 

1/2/3 

• 

• 

Ob/  U/22 

number 

i n 

SHC 

1/2/3 

• 

• 

07/15/23 

3 
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Executive 


The  executive  is  the  kernel  of  the  operating  system, 
It  controls  the  process  of 

• prior i ty  tasks 

• real-time  messaqes 

- time  dependent  (periodic)  tasks 

- background  tasks. 


Input  s 

EX  receives  two  real-time  messaqes  from  any  debug  modu 1 e * * s t ar t 
message  extraction'  and  'stop  messaqe  extraction'. 

Format i 


RMN 

S EX 

SMN 

S any 

debuq  module 

MN 

: 10 

- start 

11 

- stop 

ML 

: 04 

This  message  controls  the  state  of  the  flag  MSGExTHACTION. 
It  is  set  to  'TRUE'  uoon  receipt  of  the  'start  message 
extraction'  message  and  reset  to  'FALSE'  when  'stop  message 
extraction'  is  received. 


2,2  Funct ion 

£.2.1  System  In i t i a I i tat i on 

The  system  is  initialized  with  a call  of  procedure  EXSTAHT 
at  system  start.  Prior  to  this  call  the  variables  SAVESTACKPTR 
and  RESTART  are  set. 

SAVESTACKPTR  contains  the  value  of  the  stack  pointer  at  initial 
system  start.  It  is  saved  for  a system  restart  without  loading 
and  system  RESET. 

RE S 1 AR T is  set  to  'FALSE'  at  the  initial  start  of  the  system. 

In  case  a system  restart  is  initiated  with  INT6,  RESTART  is  set 


TRUE 


At  the  same  time  the  stack  pointer  is  reset  to  the 


saved  value. 

RESTART  is  used  by  all  modules  to  determine  whether  the  current 
start  is  a system  start  with  or  without  hardware  reset. 
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In  order  to  prevent  overlapping  program  action  caused  by 
erroneous  interrupts#  the  iAterrunts  are  locked  out  for  the 
time  of  system  i n i t i a I i zat i on . 

All  system  tables  are  reset  and  a 'start'  messaae  tor  each 
module  in  the  same  SBC  is  packed  into  the  system's  message 
buffer. 

EXSTART  ends  with  the  initialization  of  the  interrupt  control- 
ler and  an  ENABLE  instruction. 

SRC1  has  additional  tasks  at  system  initialization.  It  resets 
the  RTC»  starts  the  RTC  update  and  gives  the  start  signal 
to  all  other  SBCs  in  the  system. 

All  other  modules  in  the  system  check  their  specific  start 
variable  START1#  STARTS  etc.  to  take  on  a value  other  than  0. 
After  completion  of  the  i n i t i a I i zat i on#  SBC1  sets  the  respective 
SBC  number  into  START1,  START2  etc.  and  all  SBCs  start  their 
initialization. 


2.2.2  Priority  Calls 

In  the  context  of  priority  calls  there  are  two  relevant 
items  of  system  data:  PRIURLIST  and  PRIORSCHEDlJLE . 

PRIORLIST  is  an  address  vector  of  length  8 and  contains  the 
addresses  of  priority  procedures  entered. 

PR10RSCHEDULE  is  a byte  variable  which  indicates  the  scheduled 
priority  calls»e.g.  bit  0 = 1 means  that  a priority  call  of 
the  priority  procedure  in  PRIORLIST(O)  has  been  scheduled. 
Prior  to  the  call  of  this  procedure  the  respective  bit  in 
PRIORSCHFDULE  is  reset  to  0. 

The  executive  keeps  checking  PRIORSCHEDULE  until  all  calls 
have  been  made  before  proceeding  to  the  process  of  real-time 
messages . 

2.2.3  Communication  Between  Modules 

Common i cat i on  between  modules  uses  real-time  messages. 

These  messages  can  be  sent  from  any  module  to  any  other  module 
in  the  system. 

A message  is  considered  to  be  'internal'  if  it  is  sent  to  a 
module  in  the  same  SBC.  An  'external'  message  is  sent  to  a 
module  in  an  other  SBC. 

Internal  and  external  messages  have  the  same  format»only  the 
treatment  by  the  executive  is  different. 


- 


A messaqe  is  sent  with  a call  of  SEND.  In  this  system  procedure 
the  message  is  placed  into  MSGBUFFER#  a circular  FIFO  list. 

MSGBUFFER  is  controlled  by  two  pointers:  MSGIN  (next  to  fill) 
and  MSGOUf  (next  to  process). 

The  variable  NUMMSG  contains  the  number  of  messages  currently 
in  MSGBUFFER. 


2. 2.1. I Internal 

The  executive  checks  NUMMSG  for  a messaoe  to  be  processed. 

If  NUMMSG  = 0 then  the  executive  proceeds  to  check  for  external 
messages . 

MSGOUT  points  to  the  next  messaoe  to  be  processed. 

The  executive  computes  the  index  of  the  next  messaqe  in 
MSGBUFFER  (new  MSGOUT  = MSGOUT  ♦ ML  of  current  message). 

After  this  update#  tne  executive  examines  RMN  of  the  message. 

If  the  receiving  module  is  in  the  same  SBC  the  procedure 
MSGENTxx  is  called  (xx  = relative  module  number  in 
a SBC  ! 0 - H. 

This  procedure  is  the  messaqe  entry  of  tne  receiving  module. 


2. 2. 1.2  External 

If  the  receiving  module  of  a message  is  not  in  the  own  SBC# 
the  executive  calls  SENDEXT  to  process  this  message. 

There  is  a buffer  for  external  messages  (EXTMSG0UFFER ) which 
has  a very  similar  structure  to  MSGBUFFER. 

The  only  exception  is  that  the  receiver  of  the  messaqe 
is  the  number  of  the  SBC  which  hosts  the  receivino  module. 

An  external  message  is  kept  into  ExTMSGBUFFER  until  it  is 
processed  by  the  respective  SBC  and  transferred  into  the  local 
message  buffer. 

Since  all  SBCs  operate  in  EXTMSGBUFFER  there  is  a lock  mecha- 
nism that  prevents  two  SBCs  from  working  in  EXTMSGBUFFER  at 
the  same  time. 

Every  time  a message  is  taken  out  of  EXTMSGBUFFER  or  when  the 
first  messaqe  is  written  into  the  empty  EXTMSGBUFFER  the  vari- 
able EXT  MSG  is  set  to  the  number  of  the  receiving  SBC  of  the 
message  currently  at  the  top  of  EXTMSGBUFFER. 

If  ExTMSG  = 0 then  no  external  message  is  waiting  to  be 
processed. 

After  checking  the  external  messages  PRIORSCHEOULE  is  examined 
again. 
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2.2. <4  Periodic  Calls 


All  activated  periodic  calls  are  kept  in  PERLIST. 

PERLIST  is  a vector  of  records. 

The  variable  NUMPfcR  contains  the  number  of  activated  periodic 
cal  Is. 

PERXIBL*  a list  of  pointers  to  PERLIST,  is  always  kept 
compact*  i.e.  if  a periodic  call  is  suspended* ent r 1 es  in  PERXIBL 
are  moved  to  become  compact  adain.  This  technique  reduces 
execution  time  when  the  executive  is  checking  for  necessary 
periodic  calls. 

if  the  executive  finds  a 'next  call  time'  <=  RTC  then  a new 
'next  call  time'  is  computed  (RTC  ♦ time  interval)  and  the 
periodic  procedure  is  called. 

If  no  periodic  procedure  is  to  be  called*  the  executive  proceeds 
t to  the  background  tasks. 

Otherwise  the  periodic  procedure  is  called  and  upon  return  of 
program  control  the  priority  calls  are  checked  aqain. 

2.2. b Background  Tasks 

I 

Background  tasks  represent  the  lowest  priority  level  within 
the  executive* 

They  are  executed  only  if  no  other  task  is  pending*  i.e.  the 
processor  is  idling. 


2.2. 6 Messaqe  Extraction 

Before  processing  a real-time  messaqe*  the  executive  calls 
EXMSGEXTR  if  the  f I aq  MSGEX TRAC T ION  is  'TRUE'. 

In  this  procedure  the  current  messaqe  is  checked  against 
the  messaqe  control  bloc*  contained  in  DtBUGMCB. 

If  DEBUGMCB  matches  the  current  messaqe*  the  message  entry 
of  the  debug  module  is  called  with  a faked  'message  extrac- 
tion' message. 

Upon  return  the  current  message  is  processed. 
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Outputs 

At  System  start*  after  its  own  initialization*  EX  sends 
'start'  messages  to  all  moaules  in  the  same  SBC. 

Format : 

HMN  ” all  modules  in  own  SBC 
S*N  - EX 
MN  - 00 
ML  - 04 

Aoart  from  the  'start'  message*  EX  sends  an  'extraction' 
message  to  06  if  messaqe  extraction  is  activated  and  a match- 
ing message  was  detected.  This  message  is  'sent'  by  directly 
calling  the  messaqe  entry  of  06. 

This  special  procedure  is  chosen  in  order  to  avoid  an  ex- 
cessive load  of  the  system's  message  buffer  since  each  ex- 
tracted message  would  be  represented  twice:  as  original 
message  and  as  data  bytes  of  the  'extraction'  message. 
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i Interrupt  Handling 

All  interrupts  are  handled  entirely  bv  the  operating  system. 

There  are  four  system  interrupts  and  three  user  interrupts. 
The  system  interrupts  are: 

- RTC  interrupt 

- CDC  interrupt 

- system  restart 

- enter  iron i t o r . 

The  RTC  interrupt  (INT2)  is  activated  in  SBC  1 only. 

This  interrupt  is  generated  by  counter  0 of  the  interval 
timer  arrivinq  at  the  terminal  count  of  0. 

Counter  0 is  first  set  in  procedure  EXSTART  to  the  equiva- 
lent of  1 msec  and  started. 

Upon  occurrence  of  the  interrupt  the  RTC  is  undated  an o the 
counter  is  started  again  with  a time  interval  of  l msec. 

A CDC  interrupt  may  be  initiated  in  each  SBC.  The  COC  inter- 
rupt is  started  with  the  system  call  SETCDC. 

At  terminal  count  the  interruot  (INTO)  is  generated  and 
the  address  passed  with  the  system  call  is  called. 

The  System  can  be  restarted  without  RESET  by  generating 
INTft  at  the  front  panel  of  the  MDS.  From  the  interrupt 
process  the  procedure  SYSWkSTART  »s  called  where  the  restart 
is  initiated. 
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Ihe  SBC  monitor  can  be  entered  at  any  time  by  pressing  INT2 
at  the  tront  pane). 

This  interrupt  is  jumpered  on  the  SHCs  to  cause  an  interrupt 
on  level  1 . 

Upon  occurrence*  the  monitor  is  entered  at  location  07a0H. 

The  same  procedure  when  activating  the  monitor  with  RESET 
applies*  i.e.  typing  capital  ’U*  to  initialize  the  USARf. 

Note:  Since  the  monitor  changes  locations  in  on-board  Random 
Access  Memory*  the  system  cannot  be  restarted  without 
1 oad i ng 1 

User  interrupts  can  be  activated  on  levels  3*4  ana  5.  They  are 
activated  and  de-activated  with  system  calls  (ENTEKINT  and 
REMiNT) . 

The  interrupt  vector  is  located  at  3000H  and  has  a length  of 
t>4  bytes*  i.e.  each  interrupt  occupies  8 bytes. 

This  structure  is  compatible  with  PL/M-80. 

The  interrupt  routines  are  written  in  PL/M-80  and  therefore 
located  at  0000  - 003FH. 

After  SBC  1 is  loaded*  the  loader  transfers  the  code  for 
interrupt  processing  to  its  final  location  in  the  interrupt 
vector. 

Since  the  user  interrupts  are  restricted  by  PL/M-80  to 
INT3  - INT7*  only  S interrupts  can  be  programmed  this  way. 
These  are  the  three  user  interrupts  and  RTC  and  COC  interrupt. 
The  code  for  the  Process  of  monitor  and  restart  interrupt  is 
written  into  the  interrupt  vector  in  procedure  EXSTART. 

The  book-keeping  of  user  activated  interrupts  takes  place  in 
table  1NTTBL. 

lNTTBL(i)  contains  FFH  if  interrupt  i is  not  activated. 

An  activated  interrupt  is  indicated  by  INTTBL(j)  = k,  where 
j is  the  interrupt  level  and  k is  the  index  of  the  priority 
task  to  be  scheduled  upon  occurrence  of  the  interrupt. 


System  Oata 

System  data  are  divided  in  two  parts: 

- data  to  be  compiled  with  each  module 

- data  to  be  compiled  with  the  executive*  system  calls 
and  the  debug  module. 

The  first  data  set  is  in  the  source  tiles  SYOATP.SRC  and 
SYDATE.SRC. 

The  executive  has  to  be  compiled  with  the  PUBLIC  declarations 
of  this  data  in  SYOATP.SRC  whereas  all  other  components  of 
the  system  are  compiled  with  the  ExTtRNAL  declarations  in 
SYOATE.SHC. 
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Since  this  data  set  is  well  explained  in  the  program  listing 
(see  Section  11  in  the  operating  system  user's  manual)  it 
is  not  described  here. 

The  second  data  set  is  in  the  source  files  EXDATP.SRC  and 
EXDATE. SWC. 

It  Contains  all  data  necessary  for  the  operation  of  the  execu- 
tive and  the  system  calls. 

The  executive  has  to  be  compiled  with  the  PUBLIC  declarations 
in  txOATP.SPC.  All  other  components  which  need  to  operate  on 
these  data  (system  calls*  interrupt  handlinq#  debug  module)  can 
be  compiled  with  the  EXTERNAL  declarations  in  EXDATF.SRC. 

All  operational  data  of  the  system  are  listed  and  described 
i n Sec  t i on  9 . 


5 System  Calls 

The  code  of  the  system  calls  has  been  split  up  into  seven 
parts  in  order  to  ease  oroqram  development  and  maintenance 
under  1SIS-II.  These  program  parts  are  named  SCPUB1  - SCPUB7. 


The  object  code  of  the  system  calls  is  kept  in  the  object 
1 ibrary  SC .L IB. 

Each  module  can  be  compiled  with  the  set  of  EXTERNAL  decla- 
rations of  all  system  calls  in  the  source  tile  SCExT.SRC. 
The  matching  of  the  PUBLIC  and  EXTERNAL  declarations  takes 
place  in  the  LINK  step  during  svstem  generation  where  the 
object  library  SC. Lib  has  to  be  included. 

The  function  of  the  system  calls  is  explained  in  the  source 
program  listing. 
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Real-time  Clock  and  Count  L'own  Clock 


RTC  and  COC  are  i mp I ement ea  using  counter  0 and  1 of  the 
on-board  interval  timer. 

Both  counters  are  'down  counters'  with  a terminal  count  o*  0 
and  driven  by  a clock  input  of  l.Bo  micro  seconds. 

The  'terminal  count'  outout  line  is  jumpered  to  the  interrupt 
control  I er . 

Counter  0 generates  a level  2 interrupt  while  counter  1 is 
tied  to  INTO. 

Counter  0 (RTC)  is  driven  by  SBC  1 only.  SBC  1 loads  counter  0 
with  the  equivalent  of  1 msec  (LSB  - 1.86  micro  seconds)  and 
updates  the  RTC  (4  byte  vector  in  common  memory)  by  1 upon 
occurrence  of  the  interrupt » i.e. terminal  count  of  counter  0. 

A CUC  interrupt  is  i mp 1 emen t ed  ,i n each  SBC.  Its  initialization 
is  by  a system  call  (SETCDC).  / 

In  the  process  of  this  system/call  the  following  actions  take 
place: 

' - save  the  address’,  to  be  called  at  CDC  interrupt 

| - enable  interrupt  level  0 

I * 

• k 

- load  counter  l with  the  transferred  value 
(LSB  * 1,8b  micro  seconds). 

Upon  occurrence  of  the  COC  interrupt#  the  interrupt  on  level  0 
is  disabled  and  the  indicated  address  is  called. 
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7 Loader 


The  system  is  loaded  and  started  under  control  of  a separate 
I oade  r . 

The  loader  runs  in  the  M0S  and  is  started  together  with  the 
SHUs.  It  interacts  with  the  SBCs  through  four  absolutely  located 
variables: 

- LOADSbC  (F1F0H) 

- S T AH  I I (F  IFIH) 

- SI  Art  T«?  ( F l F «?M  ) 

- Si  AW  I J (F IF  SH)  . 

At  start  all  tour  variables  are  reset  to  0.  Ihe  SHCs  conti- 
nuously check  LOADSBC  to  take  on  the  value  of  their  SBC  number 
(I  - 3)  . 

Ihe  loader  loads  the  code  tor  SBC 1 from  the  disk  with  an 
offset(bias)  of  MJOOH.An  tSIS-ll  system  call  is  used  to  load 
the  file  LOADl. 

After  completion  of  the  loadinq  L0A0SBC  is  set  to  l.The  loa- 
der now  waits  until  LOAPSMC  becomes  0 aoain. 

SBC  I detects  the  * I * in  LOADSBC  and  starts  moving  the  code 
from  the  temporary  storaqe  into  on-board  memory  for  which  it 
was  located  before  by  the  LOCAIt  program  of  ISIS-11. 

After  completion  of  the  move#  L0A0SHL  is  set  to  0 and  then  the 
SBC  waits  tor  the  variable  START  1 to  become  1. 

The  loader  now  repeats  the  process  for  SHC<?  and  SBC3. 

After  havinq  loaded  all  SHCs#  the  loader  stores  a l in  STAHT1. 
this  is  the  siqnal  for  SBC  1 to  start. 

After  ini  t ial  umq  system  data  and  the  WIC  the  variables 
S I AH  J and  SIAHI3  are  set  to  & and  3 respectively. 

This  effects  the  start  of  the  entire  system. 

The  loader  issues  informative  messaaes  on  the  CWT  as  it 
proceeds  through  the  loading  process. 

It  should  be  noted  that  a loadinq  process  is  not  necessary 
in  a practical  application  because  the  program  would  reside 
in  Head  Only  Memory. 
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Memory  Map 
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In  this  sec  t t on  all 
cribed.  Furthermore 
1 i sted. 


absolutely  located  data  and  code  is  des- 
alt PWUM  chanqes  of  the  SriC  monitor  are 


rt.l  Absolute  nata 

Absolutely  located  data  is  necessary  for  communication  between 
SttCs  and  loading  and  starting  of  the  SBCs. 

Absolute  system  data  are  located  in  the  region  F000M  - F1EFM, 
These  data  include: 

- module  status  table  ( MUOS T A T US ) 

- real-time  clock  (MIC) 

- message  buffer  and  message  control  variables  for 
external  message  exchange. 


F 000 

F 0 i 7 

F 0 1 H 

M00ST ATUS 

F 0 1 6 

RTC 

F01C 

tX  TMSr.LOCK 

F 01D 

t X T MSG 

FOIE 

EX  TMSGIN 

F01F 

tX IMSGOUl 

F 0<>0 

NUMtx 1VSG 

F 0<?  1 
F0<?«? 

EXTLASIMSG 

• • 

F 1 14 

EXT  MSGBUFFER 

Absolute  data  for  loading  and  starting  are  located  in  the 
r eg  ton  FIFO  « F 1 F 7 : 

FIFO  LOAOSHC 

FIFl  START1 

F 1 F <?  START*? 

F 1 F 5 STARTi 

F 1 F 4 

..  key  tor  the  system  operation  (key  is  OABCUM) 

F 1 F 5 

Since  the  snapshot  function  is  implemented  with  the  trap 

instruction  RS14,  it  is  necessary  to  define  the 

entrance  of  the  snapshot  execution  in  an  absolute  location. 

Ihe  entry  address  is  storea  in  J040H  and  5041H, 
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Absolute  Code 

Apart  from  the  co>l*  for  the  SBC  non  i t or  > mH  i c h is  located 
absolutely  because  it  resiaes  in  HUM, the  interrupt  vector 
has  to  be  located  absolutely. 

Ihe  interrupt  controller  is  programmed  to  expect  the  interrupt 
vector  at  3000M  with  8 by t es/ i nt er rupt  . 

Ihe  code  tor  INI o » INI d * I Nl 3 » 1 N 1 4 and  INIS  is  moved  into  the 
vector  by  the  loader.  Ihe  rest  of  the  vector  is  set  in  the 
start  routine  (fcxSIAWl).  These  are  I Nil  (entry  of  monitor)  and 
1 N 1 1>  (system  restart). 

INI / currently  is  not  implemented. 

3000 

..  CDC  interrupt 

3007 

3008 

..  'enter  SBC  monitor'  interrupt 

300F 
3010 

. . H1C  i nter rupt 

3017 

3018 

..  1NI3  (user  interrupt) 

40  1 F 
3020 

..  INIU  (user  interrupt) 

3027 

3028 

..  INT5  (user  interrupt) 

302F 

3030 

..  'system  restart'  interrupt 

3037 

3038 

..  I N T 7 (not  implemented) 

303F 
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Changes  of  the  SBC  Monitor 


This  section  lists  and  comments  the  changes  of  the  SBC  moni* 
tor  in  PROM . 


The  monitor  needs  to  be  modified  in  order  to  allow  the 
automatic  loading  of  the  system. 

At  system  start  the  monitor  checks  a key  which  is  an  address 
value  located  in  FlFaH. 

For  operation  of  ooeratinq  system  the  user  has  to  store  the 
the  hexadecimal  value  AHCD  in  this  location.  If  the  contents  is 
different  from  this  value  the  monitor  will  operate  in  normal 


mode  . 

0000 

jmr  0/00 

C3  00 

07  jumo  to  0700H  at  WESl 

0 700 

LXl  H,KEY 

21 

F 0 

F 1 

check  key 

0704 

M V 1 A,0ABH 

3E 

Ab 

0 70S 

C Mp  M 

BE 

070t> 

JNZ  0700 

C2 

00 

07 

start  moni tor 

0709 

INx  H 

23 

070A 

MV  l A , 0CDH 

3E 

CO 

0 70C 

CMP  M 

BE 

0 700 
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Genera  l 


Int  roduc  t i on 

This  manual  describes  the  use  of  the  real-time  operating  system 
tor  dedicated  multi  processor  micro  computers. 

The  operating  system  is  designed  to  use  INTEL'S  sinqle  board 
computers  SRC80/20-4 , t heref ore  it  is  assumed  that  the  reader 
is  familiar  with 

- single  board  computer  hardware 

- PL/M-80 

- operating  system  ISIS-II  for  INTEL'S  MDS. 


Abb  rev i at i ons  and  Conventions 

All  numbers  in  this  segment  of  text  are  decimal  except  as 

otherwise  indicated. 

Task  - part  of  the  program  which  handles  a specific 

function  of  the  system  and  consists  of  one  or 
more  procedures 

Module  - part  of  the  proqram  which  consists  of  one  or  more 
(related)  tasks  and  can  be  compiled  separately 

Executive  - part  of  the  operating  system  which  contols  the 
scheduling  and  execution  of  tasks 

Operat i ng 

System  - consists  of  e x ec u t i ve # sy s t em  calls  and  system  data 

System  - consists  of  operating  system  and  all  integrated 

user  modules 


SRC  - Single  Board  Computer 


MDS 

- Microcomputer  Development  System 

(INTEL) 

mcb 

- Message  Control 

Block 

RMN 

- Receiving  Module 

Number 

SMN 

- Sending  Module  Number 

MN 

- Messaoe  Number 

ML 

- Message  Length 

EX  - 

executive# 

modu  1 e 

number 

i n 

SBC 

1/2/3  : 

00/08/lb 

LP  - 

line  printer  module 

# modu  1 e 

number 

i n 

SBC 

1/2/3  : 

OS/13/21 

CS  - 

CRT  module# 

modu  1 e 

numbe  r 

i n 

SBC 

1/2/3  : 

Ob/ 1 4/22 

DB  - 

debug  module# 

modu  1 e 

number 

i n 

SBC 

1/2/3  : 

0 1/ 1S/23 

RTC 

- Real  Time  Clock 

CDC 

- Count  Down  Clock 
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Facilities  of  the  Uoeratinq  System 

The  operating  system  is  specifically  designed  to  control 
complex  real-time  environments. 

In  order  to  meet  these  requirements  the  operating  system 
prov ides: 

- priority  task  scheduling 

- commun i c a t i on  between  modules 

- time  dependent  (periodic)  scheduling  of  tasks 

- real-time  clock  and  count  down  clock 

- system  moni tor 

- commonly  needed  functions  in  form  of  system  calls 

- interrupt  handling. 

The  operating  system  is  able  to  control  all  possible  SBC  hard- 
ware configurations.  INTEL'S  multibus  system  can  handle  up  to 
lb  master  cont ro 1 1 er * t heoret i c a 1 1 y all  SBCs. 

Code  in  memory  may  be  shared  by  several  SBCs*  however*  care 
should  be  taken  that  there  is  no  interference  with  data  access. 
By  simply  keeping  all  data  in  on-board  memory  no  data  conflicts 
can  occur. 

For  efficiency  reasons  the  executive  and  time  critical  func- 
tions should  be  kept  in  on-board  memory*  whereas  the  code  of 
the  system  calls  can  bs  located  in  common  memory  where  it  can 
be  shared. 

A module  can  take  on  the  identities  of  several  modules. 

The  body  of  the  module  is  shared  in  common  memory.  The  kernel 
of  the  module*  i.e.  the  entry  for  real-time  message*is  special 
each  SBC  as  expressed  by  different  module  numbers. 

Communication  between  modules  allow  the  sending  of  messages 
from  a module  to  another  module*  regardless  of  where  these 
modules  are  located. 

Since  messaqe  between  SBCs  as  well  as  code  executed  from  common 
memory  make  use  of  the  system  bus  the  actual  distribution  of 
the  modules  in  the  entire  computer  system  should  be  such  that 
system  bus  access  is  minimijed. 

All  executives  in  the  SBCs  are  identical*  the  bindinq  of  an 
executive  to  the  host  SBC  takes  place  during  the  compile  with 
two  compile  parameters:  number  of  SBC  and  module  number  of 
first  module  in  the  SBC. 


2 System  Organization 

*.l  Modular  Structure 

The  operating  system  supports  a strictly  modular  structure. 
Modules  are  integral  Parts  of  the  overall  system  which  usu* 
ally  handle  a soecific  task  or  a qroup  of  related  tasks. 

This  organization  not  only  eases  program  development  and 
maintenance  it  also  allows  easy -t o- i mp 1 ement  chanaes  of  the 
system. 

The  links  between  a module  and  the  rest  ot  the  system  are 
the  system  data  and  the  entry  for  real-time  messaaes  of  the 
modu 1 e • 

These  links  require 

- the  inclusion  of  system  data  in  the  compilation  of  a 
modu  1 e 

- the  marking  of  the  message  entry  procedure  as  a PUBLIC 
procedure  and  a predefined  name  to  allow  access  by 
the  executive. 

The  example  of  a complete  user  module  is  given  in  Section  9. 

A module  has  a unique  number  which  is  used  to  identify  it 
in  the  system. 

The  number  of  a module  depends  on  the  number  of  the  SBC  which 
hosts  the  module.  Each  SBC  can  have  a maximum  of  8 modules 
(0-7),  e.g.  module  3 in  SBC  2 has  the  module  number  11. 

The  lowest  module  number  in  each  SBC  is  reserved  for  the 
executive.  Implementing  the  executive  as  a module  allows 
user  modules  to  send  message  to  the  executive. 

Each  possible  module  in  the  system  has  a reserved  byte 
in  the  system  table  MODSTATUS.  This  table  contains  the  status 
of  all  modules.  If  the  entry  is  0 for  a module  the  module 
is  not  existent. 

MODSTATUS  is  updated  with  the  system  call  UPDSTAT 
(see  Section  6.12). 

Each  module  is  in  one  of  three  states:  nonexistent,  existent 
or  activated. 
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2,2  Priority  Tasks 


Priority  tasks  consists  of  one  or  more  procedures  with  one 
entry  procedure.  The  call  of  this  procedure  can  pe  scheduled. 

A scheduled  priority  task  will  be  considered  by  the  execu- 
tive as  soon  as  the  processor  becomes  available. 

Usually  the  process  of  an  interrupt  is  implemented  as  a priority 
task  where  the  scheduling  is  done  in  the  interrupt  procedure. 

In  connec tion  with  priority  tasks  there  are  four  related 
system  calls:  PRIORITY,  PR10RI1Y1NT,  ENTERPR IOR  and  REMPRIOR 
(see  Section  6 for  formats). 

A priority  task  has  to  be  entered  into  the  list  of  priority 
calls  prior  to  its  first  scheduling.  This  is  done  with  the 
system  call  EN1ERPR10R.  ENItRPRIOR  returns  an  inoe*  which  is 
used  to  schedule  a call  of  the  task  (PRIORITY  or  PRIORITYJNT) 
t or  remove  the  task  from  the  priority  list  (REMPRIOR). 

I 

PRIURITYINT  and  PRIORITY  perform  the  same  function,  however, 
PRIORITY  may  not  be  called  from  an  interrupt  procedure  and 
vice  versa.  This  prevents  erroneous  program  action  in  the 
case  that  the  processor  is  interrupted  while  executing  the 
priority  schedul inq  system  call. 
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Communication  Between  Modules 


Since  modules  are  separate  and  independent  parts  ot  the 
system#  the  ooeratinq  system  has  to  provide  a function  which 
allows  the  modules  to  communicate  with  each  other. 

This  communication  takes  place  in  form  of  a messaqe  exchanqe. 
Messages  are  sent  and  received  py  modules  and  the  sender 
and  receiver  are  identifieo  by  their  module  numbers. 


A messaqe  consists  ot  a message  control  block  (MCB)  ana#  if 
necessary#  data  bytes. 

The  MCB  has  a length  of  <1  bytes  and  the  following  structure: 


*********** 

* RMN  * 

*********** 

* SMN  * 

*********** 

* MN  * 

*********** 

* ML  * 

*********** 


Receiving  Module  Number 
Sending  Module  Number 
Messaqe  Number 
Message  Length 


The  MN  is  an  agreed  uoon  number  between  sender  ana  receiver 

of  the  messaqe  in  order  to  identify  the  meaning  of  the  message. 

ML  determines  the  total  number  of  bytes  of  the  message 

(MCB  ♦ data  bytes)  and  has  a minimum  value  of  (message  without 

data  bytes). 


A message  is  sent  with  the  system  call  SEND.  This  routine  requires 
the  address  of  the  first  byte  of  the  MCB  to  be  passed  to  it. 

SEND  returns  a 'TRUE'  if  the  message  has  been  sent  and  a 'FALSE' 
otherwise.  The  latter  can  happen  when  the  receiving  module  is 
not  activated  or  not  existent. 

If  the  message  has  been  sent#  data  bytes  may  be  stored  in  the  vec* 
tor  MSGDATA.  SEND  has  reserved  space  for  as  many  data  bytes  as 
indicated  by  ML  in  the  MCB. 

In  the  case  that  more  data  bytes  than  specified  are  written 
into  MSGDATA  they  will  be  aisreaarded. 

The  messaqe  is  inserted  into  a circular  FIFO  list. 

The  executive  checks  the  top  of  the  list  and  transfers  control 
to  the  message  entry  of  the  module  specified  by  RMN  in  the  MCB. 
Prior  to  calling  the  module  the  message  to  be  processed  is  set 
into  the  vectors  MSG  and  MSGDAIA  to  allow  access  by  the  pro- 
cessing module. 
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2,H  lime  Dependent  (Periodic)  Scheduling  of  Tasks 


A common  requirement  of  real-time  applications  is  the  time 
dependent  execution  of  tasks*  e.g.  a display  has  to  be  up- 
dated every  two  seconds  or  a process  has  to  be  triggered 
once  after  a certain  amount  of  time  has  elapsed. 

Ihe  operating  system  Droviaes  the  functions  for  executing 
tasks  of  this  kind. 

The  time  dependent  scheduling  of  tasks  is  implemented  with 
three  system  calls:  PERACT,  PERCHG  and  PERSUSP  (see  Section  b 
tor  formats ) . 

A procedure  can  be  entered  into  the  list  of  periodic  tasks 
by  calling  PEHACT  and  passing  2 parameters:  the  address  of 
the  procedure  entry  and  the  time  interval. 

PERACT  returns  an  index  which  identifies  the  task  in  the 
system  calls  PERCHG  and  PERSUSP. 

The  time  interval  can  be  changed  with  the  system  call  PERCHG 
and  a periodic  task  can  be  removed  from  the  list  with  a call 
of  PERSUSP. 

The  executive  continously  checks  the  list  of  periodic  tasks 
and  calls  the  respective  procedure  when  the  specified  time 
is  less  than  or  equal  to  the  value  in  the  real-time  clock. 


.5  Background  Tasks 

In  order  to  utilize  the  processor  in  case  that  no  prio- 
rity call  is  scheduled*  no  message  is  to  be  to  processed  and  no 
periodic  call  is  necessary*  background  tasks  can  be  called 
by  the  executive. 

Typically*  not  time  dependent  hardware  checks  are  performed 
as  a background  tasks  on  a time  slice  basis. 


5 Interrupt  Handling 

All  interrupts  are  handled  by  the  operating  system. 

User  interrupts  currently  can  be  activated  on  three  levels: 

INI  5,  INT4  and  1NT5. 

An  interrupt  is  activated  with  the  system  call  ENTER1NT. 
Parameters  for  this  system  call  are  the  requested  interrupt 
level  and  the  index  of  the  priority  task  to  be  scheduled  upon 
occurrence  of  the  interrupt. 

An  activated  interrupt  can  be  de-activated  with  the  system  call 
REMINT. 
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System  Data 

The  set  of  EXTERNAL  system  data  declarations  as  listed  in 
Section  11  has  to  be  included  in  the  compilation  of  a module. 
The  PUBLIC  definitions  of  the  same  data  are  compiled  to- 
aether  with  the  executive. 

Care  should  be  taken  in  the  use  of  the  system  work  variables. 
Since  all  modules  are  allowed  to  use  them  (except  in  interrupt 
routines)  their  contents  is  not  preserved  from  one  call 
to  the  next . 


Execut i ve 

This  section  describes  the  function  of  the  executive  and 
the  interface  between  executive  and  user  module. 

The  executive  of  the  operating  system  is  a program 
loon  which  checks  for  pending  tasks  on  4 levels: 

- priority  tasks 

- messages  to  be  processed 

- periodic  tasks 

- background  tasks. 

The  executive  only  proceeds  to  the  next  lower  level  if  no 
task  is  pending  at  the  current  or  a higher  level. 

The  only  link  between  the  executive  and  a user  module  is  the 
messaae  entry  of  the  module. 

The  executive  is  compiled  with  all  possible  message  entries 
declared  as  EXTERNAL  oroceoures  while  the  respective  PUBLIC 
declaration  is  part  of  the  module. 

During  the  linkinq  process  of  ISIS-II  the  two  declarations 
are  matched  and  the  ececutive  can  call  the  message  entry  of 
the  module  at  system  start.  It  is  up  to  the  module  to  initi- 
alize itself#  enter  priority  calls#  activate  periodic  calls 
and  set  its  own  status. 

Prior  to  calling  a module's  messaqe  entry#  the  executive  'sets' 
the  message  into  the  based  vectors  MSG  and  MSGDATA  where  MSG 
contains  the  MCB  and  MSGOATA  the  data  bytes#  it  any. 

Each  SBC  runs  its  own#  identical  executive,  fhe  only 
difference  between  the  ececutives  is  the  module  number. 
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System  Calls 


6.1 


This  section  describes  format  and 
cal  Is. 

All  system  calls  are  qiven  in  the 
NAME  TYPE  (parameter 


function  of  the  system 

form 
i s t ) . 


A TYPE  included  after  the  name  means  that  the  system  call 
returns  a value  of  the  indicated  type. 


An/Bn  in  the  parameter  list  indicate  address/byte  values. 


ENItRPRlOR 


Format 


ENTERPRIOR  BYTE  (Al) 


I nput 
OutDut 


Func  t i on 


Al  - address  of  priority  Proceoure 

. index  of  the  priority  task 

(may  be  used  for  scheduling  and  removinq  the 
task) 

. FF  if  the  task  could  not  be  entered  into  the 
list  of  priority  tasks  (overflow) 

The  indicated  priority  Procedure  is  entered  into 
the  list  of  priority  tasks.  The  index  to  this  list 
is  returned.  The  list  can  hold  up  to  8 tasks/SBC. 


b.2  PRI UR ITY1 NT/PRIORITY 

Format  : PR  I OR  I T Y I NT /PR  I OR  I T Y (Bl) 

Input  : Bl  - index  of  priority  task 

Function  : A single  call  of  the  indicated  priority  proce- 
dure  is  initiated  by  the  executive.  The  call 
occurs  as  soon  as  the  CPU  becomes  available. 

Remarks  : PRIORITYINI  is  to  be  called  from  interrupt  proce- 
dures only  and  PRIORITY  is  not  to  be  called  from 
interrupt  procedures! 

Prior  to  scheduling  a priority  task  it  has  to  be 
entered  with  ENTERPRIOR*  otherwise  erroneous  pro- 
gram action  will  occur. 
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6.5 


REMPRIOH 


Format 


RFMPRIOR  (Bl) 


Input 


Bl  - index  of  priority  task 


F unc  t i on 


The  indicated  priority  task  is  removed  from  the 
list  of  priority  tasks  and  can  no  I onqer  be 
schedu ) ed . 


b.4  SEND 

Format 


SEND  BYTE  ( A I ) 


I nput 
UutDut 


F unc  t i on 


A1  - address  of  first  byte  of  MCB 

TRUE  if  message  sent 
FALSE  otherwise 

MSGDATA  is  set  to  contain  the  data  bytes  of  the 
message . 

A messaoe  is  sent  to  another  module  with  this 
system  call. 

If  the  output  is  TRUE  the  message  is  sent  and  the 
data  bytes  can  be  written  into  MSGDATA,  if  any. 

If  the  output  is  FALSE  the  messaqe  could  not  be  sent. 
This  may  be  caused  by  a not  activated  receiving 
module  or  an  overflow  in  the  system's  message  buffer. 


6.5 


PERACT 

Format  : PERACT  BYTE  (A1,A2) 

Input  : A 1 - address  of  entry  procedure  for  periodic  task 

A2  - address  of  first  byte  of  time  interval 

(The  time  interval  is  expected  to  be  in  RTC 
f ormat  . ) 


Output 


F unc  t i on 


. index  of  periodic  task 

. FF  if  task  could  not  be  activated  because  of  an 
overt  low  in  the  list 

The  call  of  the  indicated  periodic  task  is  activa- 
ted with  the  inout  time  interval. 


Remark 


The  task  is  called  as  soon  as  oossible  and  from 
then  on  with  the  time  given  interval. 
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Format  : PERCHG  (B1,A1) 


Input  J HI  - index  of  periodic  task 

A1  - address  of  first  bvte  of  time  interval  (in  PTC 
format ) 

Function  : The  time  interval  of  the  Periodic  task  is  changed. 


Remark  : The  periodic  task  is  called  next  at  RTC  ♦ new 
time  interval. 


6.7  PERSUSP 

Format  : PERSUSP  (Bl) 

Input  : Bl  - index  of  periodic  task 

Function  : The  periodic  task  is  removed  from  the  list  of  per- 
iodic tasks  ana  is  not  called  any  more. 


0.8  ACTIVATE 

Format  : ACTIVATE  BYTE  (B1,B2> 

Input  : Bl  - number  of  module  to  be  activated 
B2  - number  of  calling  module 

Output  : FALSE  if  module  to  be  activated  does  not  exist  or 

calling  module  not  authorized 
TRUE  ot  herw i se 

Function  : The  indicated  module  is  to  be  activated. 

The  module  receives  a 'restart'  message  to  indicate 
that  it  has  to  reinitialize  itself. 


6.9  ACTIVE 

Format  : ACTIVE  BYTE  (Bl) 

Input  : Bl  - module  number 

Output  : TRUE  if  the  indicated  module  is  active 
FALSE  otherwise 

Function  : The  system  cal)  checks  the  status  of  the  input 

module  and  returns  a TRUE  if  the  module  is  active. 

‘ 
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to.  10 


SUSPEND 


Format 


SUSPEND  BYTE  («l,H2) 


Input 


B1  - number  of  module  to  be  suspended 
62  - number  of  calling  module 


Output 


F ALSt  if  the  module  cannot  be  suspended  or  calling 
module  not  authorized 
TRUE  ot  herwi se 


Function  : The  indicated  module  receives  a 'suspend*  message. 

Its  status  is  changed  from  'active'  to  'existent'. 


to  . 1 1 


PROCADR 


Format 


Output 


FunC  t i on 


Remark 


PROCADR  ADDRESS 

first  address  of  calling  procedure 

This  system  call  is  used  to  determine  the  location 
of  a procedure  at  run  time. 

Since  PROCADR  examines  the  system  stack#  it  only 
returns  a correct  value  if  called  with  the 
following  sequence  of  code: 


XYZ:  PROCEDURE: 

IF  FLAG  = 0 THEN 
DO; 

X Y Z ADR  = PROCADR; 
FLAG  = l; 

RETURN; 

end; 


procedure  body 


END  XYZ; 
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UPDST AT 


6.13 


6.14 


6. IS 


Format 

Input 


CLEARDATA 

Format 

Input 


Funct ion 


BIT 

Format 
I nput 


Output 


clearbit 

Format 


UPDSTAT  ( B 1 * B? ) 


B 1 
B2 


1 - 


suspend/activate  others 
module  authorized  to  suspend/ 
activate  others 


Function  : The  current  status  of  module  B1  is  replaced  by  B2. 
Remark 


The  status  of  a module  has  to  be  set  when  the 
module  receives  the  'start*  messaqe  in  order  to 
change  its  status  from  'not  existent'  to  'exis- 
tent' or  'activated'. 


CLEARDATA  (A1,A2) 


A 1 - address  of  first  byte 
A2  - address  of  last  byte 


Clear  data  from  A1  to  A2. 


BIT  BYTE  (Bl,B2) 


B1  - number  of  bit 
B2  - byte  to  be  checked 


TRUE  if  bit  B1  in  B2  is  set 
FALSE  otherwise 


CLEARBIT  ( B 1 r A 1 ) 


- module 

number 

- status 

bi  t 

0 : 

0 

- 

modu l e 

does  not  exist 

1 

- 

modu 1 e 

exists 

b i t 

1 : 

0 

- 

modu 1 e 

not  acticated 

1 

- 

modu 1 e 

act  i vated 

b i t 

2 : 

0 

- 

modu 1 e 

may  not  be  suspended 

1 

• 

modu l e 

may  be  suspended 

b i t 

3 : 

0 

- 

modu 1 e 

not  authorized  to 

U 


b.  lb 

St  tbit 

Format  : 

SETBIT  (Bl,Al  ) 

Input  : 

H 1 - number  of  bit 

A1  - address  of  memory  location 

F unc  t i on  : 

Bit  Bt  in  memory  location  At  is  set  to  1. 

b.  17 

SE ICOC 

Format  : 

SETCOC  BYTE.  (A1,A?> 

Input  : 

A 1 - time  interval  (LSB  = 1.8b  micro  sec) 

A2  - address  to  be  called  at  CDC  interrupt 

Output  : 

FALSE  if  CDC  already  activated 

TRUE  otherwise 

b.  18 

ILLEGAL MSG 

Format  : 

illegalmsg 

F unc  t i on  : 

Process  undefined  messaqe  for  a module. 

An  asynchronous  message  qivinq  the  MCB  of  the 
fined  messaqe  is  initiated  at  the  CRT. 

The  undefined  messaqe  is  taken  out  of  common 
MSG. 

b.  19 

ENTERINT 

Format  ! 

ENTERINT  BYTE  (B1,B2) 

Input  : 

B1  - interrupt  level 

B2  - index  of  priority  task 

Output  : 

FALSE  i'  same  interrupt  already  occupied 

TRUE  otherwise 

F unc  t i on  : 

The  interrupt  on  level  B1  is  enabler). 

Upon  occurrence  of  the  interrupt  the  call  of 
task  with  index  8<?  is  scheduled. 

b.^0 

HLM1NT 

Format  : 

REMINT  (Bl) 

Input  t 

HI  - interruot  level 

* unc  t 1 on  t 

lie  enabled  interrupt  on  level  HI  is  disabled 

a? 


System  M0ni tor 

The  system  monitor  is  implemented  as  a system  call  and  may  be 
called  when  an  internal  error  condition  occurs#  program 
limits  are  exceeded  etc. 

The  system  monitor  generates  an  'asynchronous  output'  message 
to  a CRT  module  to  indicate  nature  and  location  of  the  special 
condi t i on  . 

Format  : CALL  SYSMON  ( A 1 , B 1 » H<? ) ; 

A!  any  address  value 

B1  and  are  any  byte  values 

The  generated  asynchronous  CRT  output  has  the  following  format 

***  SYSTEM  MONITOR  : XXXX  YY  LL 

Where  XXXX  = ( A 1 ) 

YY  = (Bl) 

IL  - ( B<? ) 

It  is  recommended  to  set  Al  to  the  stack  pointer  when  calling 
the  system  monitor.  In  this  case  the  displayed  value  XXXX  will 
point  to  the  memory  location  from  where  the  system  monitor 
was  call ed. 

Bl  and  B<?  can  be  used  to  further  specify  the  condition. 

Up  to  now  the  system  monitor  is  called  with  Bl  representing 
the  module  number  and  B?  a specification  within  the  module. 

B 1 B2  condi t i on 

0 1 internal  message  buffer  overflow 

0 i priority  list  overflow 

0 3 periodic  list  overflow 

0 u use  of  illegal  periodic  index 

0 5 use  of  illegal  priority  index 

0 6 external  message  buffer  overflow 

0 7 double  occupation  of  interrupt  level 

5 0 line  printer  output  buffer  overflow 


rt 


Real-time  Clock  and  Count  Down  Clock 


V 


The  operating  svtem  provides  two  system  clocks: 


Real-time  Clock  (RTC): 

The  RTC  is  a Public  <4  byte  vector.  The  least  significant 
byte  is  RTCC3). 

The  value  of  the  least  significant  bit  is  1 millisecond. 
Maximum  time  value  is  4^94967  sec  = 71S8<?  min  = 1193  hrs 
= approx.  SO  days. 

The  RTC  is  located  in  common  memory  and. updated  by  SBC  1. 
Count  Down  Clock  (CDC): 

The  operating  system  provides  a CDC  for  each  SBC. 

The  CDC  can  be  activated  by  any  module  with  the  system 
call  SfcTCDC. 

The  CDC  has  a length  of  two  bytes  and  the  least  signifi- 
cant bit  is  1.86  micro  sec. 
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System  Loader  and  System  Start 


The  system  is  started  automat i ca I 1 y after  the  loading  is 
comp  I eted. 

To  load  and  start  the  system  the  following  steps  have  to  be 
per f ormed: 

- RESET  and  load  ISIS-11 

- enter  monitor  and  change  locations  F1F9  and  F1F5  to 
OABH  and  OCDH  respectively 

- RESET  and  load  ISIS-II 

- load  and  execute  the  loader  by  typing  'LOADER' 

- the  loader  issues  informative  messaqes  as  it  proceeds  in 
the  loadinq  process. 

The  loader  expects  the  code  to  be  loaded  into  the  SBCs  to  be  in 
the  files  L0AD1,L0AD2  and  LOADS  respectively. 

These  files  are  read  from  oisk  drive  0. 

In  case  a file  cannot  be  found*  a warning  message  is  typed  and 
and  the  loading  process  continued. 

The  loader  terminates  if  file  LQAD1  cannot  be  found  because  the 
system  cannot  be  started  without  SBC1  in  this  configuration. 

(In  a general  application*  however*  any  number  of  SBCs  can  be 
loaded  and  started  in  any  sequence.) 

« It  should  be  noted  that  in  a practical  application  of 

the  ooerat inq  system  the  on-board  code  would  reside  in  ROM. 


IB 


85 


10 


Example  of  a User  Module 


This  section  describes  an  example  of  a tyoical  user  module. 

The  example  is  oiven  in  form  of  a source  listinq  in  PL/M-RO 
to  be  compiled  under  ISIS— l I • 

DEMO:  DO; 

S INCLUDE ( : F 1 ISYD&TE.SRC) 

/*  include  external  definitions  of  system  data  */ 


/* 

************************************************************ 
* * 

**  DEMO  SUBSTITUTIONS 

* / 

DCL  DM  LIT  '0i'»  /*  module  number  of  DEMO  */ 


ENDSUBST  LIT  ’O'; 

/• 

************************************************************ 
* « 

**  DEMO  VARIABLE  DATA 

*✓ 

DCL  VARDATAREG  BYTE, 

(DMPERX,DMPRIORX)  BYTE, 

/*  storaqe  for  DM  periodic  and  priority 
indices*/ 

(DMPEREL,DMPRIORFL)  BYTE, 

/*  f 1 aqs  controllinq  execution  of  DMpER 
and  DMPRIOR  */ 

(DMPERADR,DMPRIORADR)  ADDRESS, 

/*  storage  for  entry  addresses  of  periodic 
and  priority  procedures  */ 


VARDATAEND  BYTE,* 


IP 


86 


/* 

* A * 
** 

* * 
*/ 
DCL 


************************************************ 
DEMO  CONSTANT  DATA 

DM  T IM£ IN  I (a)  BYTE  INITIAL  ( 0 , 0 , 3 , OEflH ) , 

/*  time  interval  for  DM  periodic  : 4 sec  */ 


DMMSG  (4)  BYTE  INITIAL  ( <1 , DM , 1 0 , 7 ) , 

/*  MCB  for  message  to  module  4 */ 


DMENOCONST  BYTE; 

$INCLUDE(:F1:SCEXT.SRC) 

/*  include  external  definitions  of  system  calls  */ 


/* 


********************* i 


* * 

**  DEMO  UTILITY  ROUTINES 

*/ 

DMUT1:  procedure; 


END  DMUTi; 


DMUTn:  PROCEOURt; 


/* 


END  DMUTn; 


i************** 


** 

**  DEMO  PRIORITY  PROCEDURE(S) 

*/ 

DMPRIOR:  procedure; 


IF  DMPRIORFL  = 0 THEN 

/*  first  call»find  entry  address  of  DMPRIOR  */ 

do; 

DMPRIORADR  = PROCADR; 

DMPRIORFL  = I! 

RETURN; 

end; 


END  DMPRIOR; 
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/* 

****** 

* * 

** 

*/ 

DMPER: 

IF  DMPERFL  = 0 THEN 

/*  first  call*find  entry  address  of  DMPER  */ 

do; 

DMPEKAOR  = PROCADR; 

DMPERFL  = i; 

RETURN; 

end; 


***************************************************** 
DEMO  PERIODIC  PROCEDlJRE(S) 

PROCEDURE; 


/* 

******** 

** 

* * 

*/ 

DMSTART ; 

call  ClEARDAT A ( .vardatabeg, . VARDA TAEND) ; 

/*  clear  variable  data  */ 

CALL  DMPRIOR; 

call  dmper; 

/*  determine  entry  addresses  of  procedures  */ 

DMPRIOKX  s ENTERPRIOR(DMPRIORADR) ; 

/*  enter  priority  call  of  DMPRIOR  */ 

OMPERX  = PERACT (DMPERADR, .DMTIMEINT (0) ) ; 

/*  activate  oeriodic  call  of  DMPER  */ 

CALL  UPDSTAT(DV,3); 

/*  set  module's  status 

3 - existent  and  activated  */ 

IF  NOT  SEND! .DMMSG(O) ) ThEN  RETURN; 

/*  send  demo  message  to  module  4 with  data 
bytes  0 » l # 2 * / 

DO  Bl  s 0 TO  2; 

MSGDATA(Bt)  = b^- 
end; 


end  DMPER; 

*********************************************** 
DEMO  START  PROCEDURE 

procedure; 


• • 

END  DMSTART; 
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DEMO  REALTIME  MESSAGE  ENTRY 


*/ 

MSGENT03 


PROCEDURE  PUBLIC 


IF  MSG (MN ) = 0 THEN 

/*  start  messaqe  */ 

do; 

call  dmstart; 

RETURN; 

end; 


/*  process  of  other  defined  real-time  messaqe  */ 


END  MSGENT03 
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SVSflON:  PROCEDURE  <P1,  P2,  P3>  EXTERNAL; 

DECLARE  PI  ADDRESS,  <P2,  P2>  BVTE; 


PL/M-80  COMPILER  PftOE 


X 

o 

X 

x 

Li 


-I  X 

X O 

2 Lt 

X Lt 

UJ  LJ 

h- 

K 

X 

2 Lt 

_i 

2 

->  O 

'X 

X o 

Lt 

O H 

7*  0 2 

£ 

X X 

x ct  o 

Li 

LJ 

Ct  >-i 

1 — 

2 O V 

2 Li  t- 

X 

►-*  t— 

Li  . a; 

Li 

H X Li 

X U1  X O 

Z H O h 

Li 

1—  2 >-• 

X Ll  X 

H 

Dh|-LI 

O O M 2 *-• 

> 

X Ll 

HlIXGO 

x 

ZUt-H 

>-t  _i  LI  <->  Li 

« 2 O 3 

2 _i  H Lt 

2 

.'V  Ll 

►H  x X 

o x 2 i li 

g 

•H  Ll 

X 2 LJ 

2 0 0 0 

z 

lL  Li 

H +*  I 

-H  O 1 

10 

v iX 

2 X 1- 

r Li  >-  -i 

> 

O 

>-•0X0 

Ll  CD  <—  M 

li  Li  a 

X - 

i-  a i a. 

O Ll  X 

Ll  > 2 

a z> 

X Ll  X Ll 

> <r  o h cm 

\ 2 

O H 

LJ  D _J 

O 

H 

_J 

X 

O 

X 

X 

LJ 

h- 

H 

X 

X 

►1 

Li 

X 

_l 

X 

Ll 

X 

X 

Li 

r* 

X 

t- 

N 

X 

X 

•v 

H 

X 

o 

X 

\ 

H 

X 

X 

o 

r\ 

X 

X 

Ll 

tH 

2 

X 

I 

Ll 

v 

1— 

H Ll 

O 

»-* 

X X 

y- 

XI  X 

3 H 

v X 

2 

X H 

X 

O 

KH 

o > 

X 

X O 

O X 

t-  2 

X X 

X 

X LJ 

> O 

3 

o 

X O H 

X i-i 

Ci  H 

2 

d| 

X 

I 

O 

o 

2 

X 

K 

3L 

2 

X 

o 

H 

I 

X 

h- 

Ll 

X 

It  II 

II  II  II  II  II  II 

II  II  II  II  II 

II  II  II  II 

II  II  II  II 

II  II  II 

CM  H 

CM 

CM  tH  CM 

CM 

ri  CM 

CM 

H CM 

M 

*t  lil  X 

N 

x on 

X 

X X 

X 

XXX 

X 

X X 

ffc 

- 33 

94f 

i 


END  PRCKMCB; 
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. 

1 General 

1.1  I n t roduc  t i on 

I he  i mo  I emen  t e d debug  functions  are  soecifieally  des  tan  eel 
to  ease  the  debugging  of  user  modules  running  under  the 
control  of  the  r e a 1 - 1 i m e operating  system  without  interference 
w i t n the  oper.it  ion  of  the  system. 

Since  the  oetiua  module  (1>H)  is  a user  module  itself#  the  functions 
are  available  only  if  this  module  is  integrated  into  the  system. 

The  debug  module  communicates  with  the  user  using  the  INI# 
therefore  the  integration  of  the  f.  K T module  (IS)  is  also 
necessary . 

It  the  user  wishes  to  obtain  hard  cones  of  the  debugging 
results#  toe  line  printer  module  ( L R 1 has  to  be  integrated#  too. 

Inputs  at  the  CHI  are  terminated  with  the  R t T U R N key. 

The  line  editing  functions  of  the  CS  module  can  be  used. 

I 

I 

1.2  Abb  re v i at i ons  and  Conventions 

I 

All  inputs  and  outputs  of  the  debug  functions  are  in  the  hexa- 
decimal number  System. 

Numbers  in  this  text  are  decimal#  hexadecim.il  numbers  are  trailed 
by  the  letter  ' H ' . 

i 

OH  - module  identification  of  debuq  module 

CS  - module  identification  of  CRT  module 

LR  - module  i den t i f i c a t i on  of  line  printer  module 

RMN  - receiving  module  number 
S M N - sendinq  module  number 

MN  - message  number 

ML  - message  length 

MCH  - message  control  block 

MCH  consists  of  <4  bvtesi 
RMN 
SMN 
MN 
ML 

SHC  - single  board  computer 

hard  copy  - printer  output  of  debug  function 
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<?  Initiation  of  the  Debug  ^oc? 

The  aetnig  mode  is  enttreii  wit*  the  input  of  ' Control-  P * at  the 
CRT  nevboarl.  I he  debug  module#  if  integrated#  responds  with 
• Dfc  HuG  CPIH:'  and  e.pects  the  input  of  the  number  of  the  Sol 
which  the  user  wishes  to  debug. 

Depending  on  the  input  the  following  system  reactions  are 

oos  s i p 1 e : 

• SHC  nu«ter  not  specified: 

» '?•  is  typed  and  'DEriUG  CPTW:1  is  repeated. 

- Weauested  SHC  is  not  activated: 

•CPrw  NUT  4C  I I V A TED » Dt  tU»G  I tWMl  NA  TED ' is  typed  and  the 
debuq  mode  is  left. 

• Requested  SHC  already  debugged  from  another  SHC: 

•CPIH  ALREAOr  DEBUGGED, DEHUG  I E MM  I \A  T t D ’ is  typed  and  the 
debug  mode  is  left. 

- I nou t acc  ep  t ed : 

The  system  responds  with  a new  line  ana  the  prompt  charac- 
ter of  the  debud  function  ’>'. 

Now  any  of  the  debug  commanas  described  in  Section  5 mav  be 

en  t e red . 


Use  of  the  Oebuo  Functions 

In  this  section  the  inputs  and  outputs  of  all  debug  functions 
are  described. 

Furthermore#  some  hints  for  the  usage  are  given. 

In  the  followina  description,  system  outputs  are  qiven  prefaced 
by:  'SYSTEM  OUTPUTS'  . 

Debug  commands  are  promo tea  with  '>'. 

If  a debug  command  requires  more  than  1 input#  these  commands  are 
prompt  ed  with  ' : ' . 

Illegal  inputs  are  reported  with  the  output  of  '?'. 


'.I  Inspect  and  Change 


Th»s  (unction  allots  the  display  of  byte  and  address  values  and 
is  invoked  hy  ' A ' (for  address)  or  ' B ' (tor  byte). 

The  *C’  command  allows  the  change  of  the  address  or  byte  value 
displayed  last. 

Address  inspection; 

X 

> A XXXXcr  ' A X X X X ; Y Y Y Y 

> ' 

Note:  Ihe  contents  of  the  address  value  is  displayed 

in  the  format  a user  would  read  it.  Ihe  internal 
representation  in  memory  is  in  the  reverse  byte  form. 

Byte  inspection: 

>H  xxxxcr  'rtxxxx  : yy 
> • 

Change  of  contents: 

> A XXXXcr  ’AXXXX  : YYYY 
>'CZZZZcr  'AXXXX  : ZZZZ 

> • 

>«  XXXXcr  'Hxxxx  ; YY 

> ' C Z Z c r ' B x x x x : zz 

> • 

Note:  A change  command  cji.  be  repeated#  it  always  refers 
to  the  last  inspected  memory  location  (address  or 
byte)  . 

The  change  command  is  only  leqal  following  an  in- 
spect command. 

The  input  of  address  values  is  in  user  readable 
format  and  not  in  internal  machine  ren re  sen t a t i on . 

Note:  If  the  last  command  has  been  'A',  'B'  or  'C'  then  the 

input  of  WETUKN  only  will  display  the  next  bvte  or  address 
value. 


oo 


I 


Memory  Dump 


S.<> 


i 


this  function  the  user  can  display  a contiguous  portion 
of  memory  specified  by  a begin  and  end  address. 

The  dump  alines  the  display  of  either  byte  or  address  values. 

The  range  of  the  dump  can  be  specified  in  c?  different  ways: 

DHxxxx,z  or  unxxxx-yyyy 

where  XXXX  is  the  begin  address 
yyyY  is  the  end  adoress 

Z is  the  number  of  values  to  be  dumped 
Dump  of  byte  values: 

OBXXXX , Zc  r 

•BXXXX  : VV  VV  VV  VV  ...  (up  to  16  byte  values/row)' 

Dump  of  address  values: 

DAXXXX,  Zcr 

' A X X X X : VVVV  VVVV  VVVV  ...  (up  to  8 address  values/row)' 


3.3  Snapshot 

This  function  allows  the  display  ('snapshot’)  of 

- CPU  regi st ers/ f I aos 

• up  to  16/3 ? contiguous  address/byte  memory  locations 

- independently  specified  address  or  byte  memory  locations 

before  the  execution  of  a specified  instruction. 

Furt hermore» t he  taking  of  the  snapshot  can  be  conditional  in 
the  sense  that  a specified  memory  location  has  to  have  a speci- 
fied value  at  the  time  of  the  snapshot. 

The  taking  of  the  snapshot  and  the  display  of  the  results  do 
not  influence  the  operation  of  the  system. 

The  snapshot  remains  activated  until  terminated  as  described 
in  Section  4.  The  function  is  executed  each  time  the  speci- 
fied snapshot  instruction  is  executed. 

Note:  Because  of  the  snapshot  method  nf  inserting  a trap  instruc 
tion  it  is  not  possible  to  activate  a snapshot  in  a ROM 
section  of  the  program. 


v, h f» r c»  'S’  is  the  d e b u d command  and  XXXX  the  address 
of  the  first  byte  of  the  snapshot  instruction. 

Note:  If  the  snapshot  address  is  not  set  to  the  first 
bvte  of  an  instruction,  an  erroneous  program 
ac  t i on  may  occur  . 

The  parameter  list  can  be  any  cnmbin.it  ion  of  the 
following  1 nnut s : 

- W 

fhis  parameter  reduests  the  display  of  .ill  Cf’L* 
reaisters  ano  flaos. 

- D 

Ihis  parameter  specifies  a contiguous  region  in 
memory  whose  contents  at  the  time  of  the  snapshot 
is  to  be  displayed.  The  format  of  the  parameter  is 
identical  to  the  debud  function  'dump*  described 
i n Sec  t i on  3 . . 

The  region  to  tie  dumped  is  limited  to  10H/«?0H 
address /by t e values. 

- A o r H 

Ihese  parameters  have  the  form  A X X X X or  HXXXX 
and  cause  the  display  of  address/hyte  value  at 
location  XXXX  respectively.  A mavimum  of  S loca- 
tions, either  address  or  byte,  can  be  specified. 


Ihis  parameter  has  the  format 
MXXXX-YY 

where  XXXX  is  a bvte  location  in  memory  and  YY  the 
specified  contents. 

If  this  condition  is  set  and  the  contents  of  XXXX 
is  not  YY,  then  the  snapshot  is  not  taken. 

Ihis  feature  allows  to  check  the  state  of 
the  system  at  a specified  iteration  of  a loop 
(M  parameter  is  the  in dev  variable)  or  to  monitor 
the  occurence  of  a specified  input  to  the  system. 


Guti'ut  format  : 

The  snapshot  function  has  no  outputs  until  the  specified 
instruction  is  executed. 

If  no  parameter  was  specified  in  the  ’S'  command  then  only 
the  standard  output  occurs: 

•SNAPSHOT  AT  XXXX  *.  YY  YY  YY* 

where  XXXX  is  the  snapshot  address  and 

YY  YY  YY  is  the  snapshot  instruction  (max  3 bytes). 

The  output  initiated  by  the  parameters  is  sel f *expl anatorv. 

If  durinq  the  output  processing  of  the  snapshot  results 
another  snapshot  occurs#  it  will  be  suppressed . T he  number 
of  suppressed  snapshots  is  typed. 
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S.u  Messaa*  Simulation 

This  function  allows  the  aeneration  of  real-time  messages  and 
is  useful  to  triqaer  processes  for  which  the  initiating 
module  is  not  inteorateri  or  the  initiation  innut  is  not 
a v a i ladle. 

After  the  input  of  the  debug  command  ’MS*?  the  function  promrts 
the  user  for  inputs  in  order  to  construct  the  message  to  be 
simulated. 

1 he  input  format  is  shown  bv  the  following  example. 

I nput  format : 

>M3c  r 

•HMNj'Wcr  'SMNt’Bcr  'MNjMOcr  'ML:  'her 
•DATA  HYTES:  ' lOcr  ' : VOcr 
'MSG  SENT 

> • 

The  above  commands  would  cause  the  sending  of  a message 
with  the  receiving  module  number  WH,  the  sending  module 
number  B?  message  number  IGH,  message  length  o with  two  data 
bytes  1 0 H and  «?  0 H . 

The  minimum  messaqe  length  is  4 (length  of  MC  B ) . 

Maximum  message  length  is  ?4H:  MCH  and  <?0H  data  bytes. 

The  input  of  data  bytes  is  promoted  aut omat i ca 1 1 y depending 
on  the  specified  messaqe  length.  The  message  is  sent  as  soon 
as  the  input  is  completed. 

After  the  prompt  symbol  reanears  the  same  message  can  be 
repeated  with  the  input  of  the  RETURN  key  only. 


In  the  case  of  an  illeqal  input  during  the  input  of  the 
message?  the  same  (wrong)  input  is  prompted  again. 

If  the  specified  messaqe  cannot  be  sent  by  the  system 
because  the  receiving  module  is  not  activated?  then 
•MSG  NUT  StND*  is  typed. 


mmmm 


wmtmm 


mm 


wm 


\.5  Mf ssao*  fc»t  ract  ton 

Ihis  function  allows  the  interceDt ion  of  any  specified  real-time 
message  at  anv  time. 

The  user  can  specify  anv  combination  of  RMN,SMN*MN  and  ML. 

If  the  specified  message  is  to  he  processed  bv  the  receiving 
modu !e#the  message  (including  data  bytes)  is  typed  on  the  CRT. 

The  mput/outout  formats  are  illustrated  with  the  following 
e « amp  I e . 

Input  format : 

>Mtc  r 

' WMN  : ’ 1 7c  r 'SMN:M0cr  'MNt'cr  • «L  : ' c r 

An  input  request  answered  with  the  input  of  RLTURN  only 
has  the  meaning  of  'not  specified'.  In  the  above  example 
all  messages  from  module  10H  to  module  1 /H  are  extracted 
because  MN  and  ml  are  not  specified  and  can  take  on  every 
value. 

Output  format : 

' RMN : 17  SMN:  10  MN:  11  ML:  16  DATA:  VV  VV  

VV  VV  

(ir  to  1 6 by  t es  / 1 i ne  ) 


> . 6 Periodic  Inspect/Oump 

This  feature  repeats  the  output  of  an  'inspect'  or  'dump' 
function  at  maximum  system  speed  and  allows  therefore  a con- 
tinuous 'look'  into  memory  in  order  to  observe  changes  of  vari- 
ables* status  bits  etc. 

These  functions  are  initiated  bv  the  same  commands  described  in 
Section  3.1  and  5.<?  with  the  difference  that  they  are  preceded 
by  the  letter  'P'  (for  periodic), 

t x amp  1 es : 

PDBXXXX,ZZcr 

PDAXXXXcr 

Note:  The  number  of  values  to  be  dumped  by  the  periodic  dump 
is  restricted  to  10H/<?0H  address/byte  values. 

A larger  range  is  cut  down  to  this  maximum  length  by  the 
debug  func t i on . 

'Maximum  system  speed'  is  ususallv  determined  bv  the  speed  of  the 
output  media. 
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Hard  Cony 


This  function  allows  the  user  to  obtain  hard  copies  of  the 
debugging  results. 


If  a hard  copy  is  reques t eo , t he  outputs  of 


memory  inspection 


- memory  dump 


- snapshot 


message  extraction 


- periodic  functions 


are  directed  to  the  line  printer. 


The  user  may  switch  at  any  time  between  the  CUT  ang  line  printer 
output . 


Default  output  device  is  the  CHT. 


Input  format 


>Hc  r 


The  first  'H'  command  switches  output  to  the  line  printer, the 
next  'H*  command  switches  bacx  to  CHT  and  so  forth. 


If  output  is  switched  to  the  Tine  printer, the  print  head  is 
positioned  at  the  top  of  a new  page. 


In  case  the  line  printer  is  not  connected  properly,an 
asynchronous  message  ’LINE  PRINTED  NUT  CONNECTED'  is  typed 
on  the  CUT  and  the  ' H ' command  is  disregarded. 
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I e rm  i na  t i on  of  a I'ehuq  Function 


selected  debug  function  terminates 


di f f erent  ways  5 


a)  The  function  terminates  itself  after  the  inspection  of  a 
memory  locat i on. In  this  case  the  system  shoes  the 
prompt  character  ’>'. 

h)  If  a dehua  function  requires  more  than  t input  or  is 
executed  per i odi c a l l y * i t can  be  terminated  with  the 
input  of  'Control-!'  at  any  time.  The  system  responds 
with  the  prompt  character. 

c)  At  any  time  within  the  debug  mode  the  CRT  interruption 
'Control-I'  can  be  used  to  disconnect  the  debua  module 
from  the  CRT.  In  this  case*  however*  not  only  the  currently 
activated  debuo  function  is  stopPed*the  clebuq  mode  is 
terminated  as  well. 

The  only  system  reaction  is  the  positioning  of  the  cursor 
to  the  beginning  of  a new  line. 


Termination  of  Debug  Mode 

The  debuq  mode  can  he  terminated  in  2 different  ways: 

a)  Use  of  the  debug  command  'T'. 

This  input  can  be  made  when  the  oromct  character  is  dis- 
played and  a regular  command  is  expected. 

The  system  responds  with  'DEBUG  TERMINATED'  and  leaves 
the  debug  mode. 

b)  At  any  time  the  procedure  decribed  in  4 c)  can  be  used. 
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Summary  of  Debun  Commands 
Debun  Functions: 

A - inspect  address  value 

B - inspect  byte  value 

C - chanqe  address  or  byte  value 

D - memory  dump 

H - hardcopy 

MS  - message  simulation 

Mx  - messaqe  extraction 

P - inspect/dump  in  periodic  mode 

S - snapshot 

T - terminate  debug  mode 

Other  Debuq  Inputs: 

Control-D  - initiate  debuo  mode 
Control-T  - terminate  debuq  function 

Control-I  ” CR!  interruption  (terminates  debuq  mode) 
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3.7.1 
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15 
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General 
1 n t r oduc  t 1 on 

The  debuq  module  (module  iaent i f icat ion:  DB)  allows  the 
debuqqinq  of  dll  modules  in  all  sinole  board  computers  under 
real-time  conditions. 

This  means  that  the  use  of  a denuo  function  does  not  influence 
the  operation  of  the  system. 

Since  each  sinqle  board  computer  has  its  own  kernel  of  the 
debuq  module*  it  is  possible  that  several  users  debuq  different 
prodram  parts  at  the  same  time. 

There  are  no  special  requirements  for  the  integration  of  DB 
except  that  at  least  one  CRT  module  has  to  be  integrated*  too. 

The  CRT  and  the  line  printer  are  the  I/O  media  of  the  debuq 
module.  Real-time  messages  are  used  to  communicate  with  the 
respective  modules. 


1.2  Abbreviations  and  Conventions 

All  numbers  in  this  seament  of  text  are  decimal  except  as 
indicated  otherwise. 

SBC  - sinole  board  computer 

MC8  - message  control  block 
RMN  - receiving  module  number 
SWN  » sending  module  number 
MN  - message  number 
ML  - messaae  lenqth 

CS  - CRT  module*  module  number  in  SBC  1/2/3  : 06/1U/22 

EX  - executive*  module  number  in  SBC  1/2/3  : OO/OS/lo 

DB  - debuq  module*  module  number  in  SBC  1/2/3  : 07/15/23 

LP  - line  printer  module*  module  number  in  SBC  1/2/3  : 05/13/21 


' 
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faci  I itifs  of  the  Oebuo  ^oculo 


The  (ifhuo  module  offers  the  following  orhug  functions  under 
real-time  conditions: 

- inspection  and  change  of  byte  ana  address  values 

- memory  dump  of  byte  and  address  values 

- snapshot  with 

. rpqister  dump 

, dump  of  specified  single  memory  locations 
. dump  of  one  contiguous  reqion  of  memory 
. specified  condition 

- message  simulation 

- message  extraction 

- periodic  i n spec t i on / aump 

- choice  between  CUT  and  line  printer  output 


1.4  Module  Organisation 

Because  of  its  size  the  OB  module  has  been  split  up  into 
B parts  in  order  to  ease  program  development  and  proqram  main- 
tenance under  the  IS1S-JI  operating  system. 

The  single  parts  of  DU  are  program  modules  in  the  sense  of 
PL/M-80  and  1S1S-I1. 

Each  of  the  B parts  has  a seperate  source  tile  while  the  object 
code  is  kept  in  one  object  library  which  represents  the  object 
code  of  the  OH  module. 

In  the  following  trie  parts  of  OB  are  described  briefly: 

OHMOD 1 : This  part  is  the  entry  for  real-time  messages  in  OH. 

It  also  includes  the  PUBLIC  definitions  of  all  DB  data 
and  the  START  procedure. 

ORNu-iO?:  This  part  processes  all  input  messages  from  the  CRT  module. 
It 


- performs  the  initialization  of  the  debug  mode 

- relays  debug  requests  to  responsible  debug  modules 
in  other  SBC  1 s if  necessary 

- distributes  cebug  incuts  ana  messages  to  the 
respective  debug  function. 

The  program  and  data  organization  of  DHMUO?  allows  easy 
to  implement  additions  to  the  debug  functions. 
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DR^ODS:  Vemorv  msoect  ion  ana  cn^nqe 
DRMOQu : Memory  dumo 
DBMOOS:  SnansOot 

D B M 0 D h : M e s s a a e simulation  and  extraction 

DRM007:  System  test 

OBMODS:  DR  utility  routines 

0BMUD9:  DB  utility  routines 
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Input  Real-time  Messages 


DB  obtains  all  inputs  from  the  CRT  module. 

The  format  of  the  debug  inputs  is  described  in  the  user's 
manual  for  the  debug  functions. 

In  this  section  the  format  and  contents  of  all  input  messaaes 
is  described.  The  respective  process  can  be  found  in  Section 
5.7. 


Start 


Rmn 

DB 

SMN 

EX 

MN 

00 

ML 

04 

messaqe  informs 

DB 

that  the 

system 

t lex  t 

f rom  CRT 

RMN 

DB 

SMN 

CS 

MN 

20 

ML 

depends 

on 

1 enqt  h of 

i nput 

DATAO- 

D A T An 

ASCII  i nou  t 

charac t e 

r s 

This  messaqe  transmits  input  text  from  the  CRT  to  DB. 

Terminate  I/O 


RMN  : 

DB 

SMN  : 

CS 

MN  : 

22 

ML 

04 

messaqe 

i S 

during 

ac  t 

Start  Debuq 


RMN  : 

DB 

Smn  : 

CS 

mn  : 

23 

ML 

04 

This  messaqe 

i s 

made  at  the 

CRT 

debug  mode. 

- b - 


External  Start 


RMN 

DM 

SMN 

DB 

modu  1 e in 

other  SBC 

MN 

24 

ML 

Ob 

DA  [AO 

number  of  CS 

module  for  debug 

inputs  and  outputs 

This  message  i s 
anot  her  SBC  . 

rece i ved 

when  the  host  SBC 

is  to  be  debugged  from 

DAT  AO  contains 

the  modu 1 e 

number  of  a CS  module  to  communicate 

with. 

Terminate  Debug 

Function 

RMN 

DB 

SMN 

CS 

MN 

Pb 

ML 

oa 

This  message  informs  DB  that  a 'Control-!' 

input  was  made  at  the 

CRT  keyboard. 

With  this  input  the  user  wishes  to  terminate  the  currently 
selected  debug  function. 


Output  Acknowledge 


RMN 

DB 

SMN 

CS  or  LP 

MN 

26 

ML 

05 

DA  T AO 

tel  1 oac  k 

code 


This  message  is  sent  by  CS  or  LP  in  order  to  indicate  that  the 
output  requested  by  DR  has  been  completed. 

The  returned  acknowledge  code  is  the  code  sent  to  CS  or  LP  with 
the  'output  with  acknowledge'  message. 


Message  extraction 


RMN  : 

DB 

SMN  : 

EX 

mn  : 

27 

ML 

deo 

DATA  - 

DATAn  : 

MCB 

This  message 

i s 

t he  execut i ve 


received  when 
has  intercepted 


messaae  extraction  is  activated  and 
a message  snec i f i ed  for  extraction. 
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Processing 

This  section  describes  the  function  of  the  debug  facilities 
and  the  process  of  the  received  real-time  messages. 


Inspect  and  Change 

The  process  of  this  function  is  contained  in  DH^ODi  and  con- 
sists of  3 procedures: 

DHINSPECT,  DBCHANGE  and  TYPEINSP. 

DBINSPECT  js  called  when 

a)  a 4.B.PA  or  P8  command  has  been  entered  at  the  CUT 

bJ  RETURN  only  was  entered  at  the  keyboard  and  the 
last  activated  function  was  A, 8 or  C 

c)  an  acknowledge  message  was  received  and  the  last 
command  was  PA  or  PB. 

In  case  a)  the  address  of  the  memory  location  is  decoded 
from  the  input  message. 

If  the  input  was  not  legal,  the  error  indication  is 

sent  to  the  CRT  module. 

If  a periodic  output  was  requested,  the  cursor  is  positioned 
at  the  beginning  of  the  input  line  and  TYPEINSP  is  called  with 
acknowledge  reguest. 

Otherwise  TYPEINSP  is  called  with  the  output  followed  by 
the  prompt  character. 

DBCHANGE  is  called  for  the  execution  of  the  ' C * command. 

If  the  previous  input  has  not  been  A,  d or  C>  then  the  change 
is  not  legal  and  an  error  is  indicated. 

Otherwise  the  new  contents  is  stored  and  TYPEINSP  is  called 
to  type  address  and  new  contents. 

DBCHANGE  terminates  with  the  issue  of  the  prompt  character. 

TYPEINSP  performs  the  output  of  the  current  'inspect  and 
Change*  address  and  the  respective  contents  (byte  or 
address ) . 

Depending  on  the  state  of  the  flag  DBTELLHACK  this  is  done 
with  or  without  acknowledge  request. 
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3 . <?  Memory  Oumo 

The  memory  dump  is  performed  hy  DHM0D4  and  consists  of  B 
procedures : 

DBDUMP , DUMPDECODE,  I N I TDUMP , DUMPLINE  and  DUMP. 

DBDUMP  is  the  entry  procedure.  From  here  the  respective 
routines  to  set  up*  execute  or  repeat  the  dump  (in  case  of 
periodic  dump'  are  called. 

UUMPDECUDE  determines  the  mode*  byte  or  address*  and  the  range 
of  the  dump. 

In  case  of  an  illeaal  input*  a looical  'FALSE'  is  returned* 
otherwise  a 'TRUE'  is  returned. 

DUMPDECODE  is  called  from  DBDUMP  and  DHSNAP  (see  5.3). 

DUMP  is  the  procedure  which  actually  performs  the  dump  from 
DUMPBEG  to  DUMPEND. 

DUMP  is  called  from  DBDUMP  and  SNAPSHOT. 

The  procedure  keeps  calling  DUMPLINE  until  the  flag  OUMPDUNE 
becomes  ' TRUE ' . 

INITDUMP  sets  up  the  format  of  the  output  line.  It  packs  the 
address  of  the  first  value  typed  on  a line  and  determines 
the  number  of  values  typed  on  a line  deoendinq  on  the  mode 
of  the  dump. 

DUMPLINt  packs  the  contents  of  the  memory  locations  starting 
at  the  current  address.  Up  to  ENOLINE  values  are  packed  for 
a line.  DUMPLINE  uses  the  utility  procedures  PACKBYTE  and 
PACKAUR  to  convert  the  contents  of  memory  locations  into 
ASCII  codes  and  pack  into  DB  output  buffer. 


3.3  Snapshot 

The  snapshot  function  constitutes  DBM0D5  and  consists 
4 procedures. 

Basically  the  snapshot  is  enabled  by  replacing  the  operation 
code  of  the  instruction  at  the  snapshot  address  by  the  trap 
instruction  RST4.  The  actual  snapshot  is  taken  when  this 
instruction  is  executed  ana  an  'interrupt'  occurs. 

The  display  of  the  snapshot  data  is  performed  with  a 
priority  call  scheduled  curing  the  process  after  the  execution 
of  the  trap  instruction. 

The  snapshot  remains  activated  until  it  is  terminated  by  a 
command.  At  this  time  the  original  instruction  is  restored 
at  the  snapshot  address. 


\ < 


If  the  system  is  stopped  wifh  an  activated  snapshot  ami 
started  aoain  without  new  loadinq,  the  snaoshot  address  still 
contains  the  WSM  instruction. 

The  start  procedure  of  OH  checks  for  an  activated  snapshot 
before  system  stoo  and  restores  the  oriainal  instruction 
i f necessary  . 

DBSNAR  initiates  the  snapshot  and  performs  the  followinq 
tunc  t ions! 

- reset  all  relevant  snapshot  data 

- process  CRT  input 

. ' R ' - set  HtGFL 

. 'M*  - set  SNCONDADR  to  condition  address  and 
SNCONDSAVt  to  the  condition 
set  CONDFL 

. 'D'  - determine  address  and  type  of  dump 

(procedure  DUMPDE.CUDE  is  used) 
set  DUMPFl 

. 'A'/'H'  - determine  address  and  type  of  the  reques- 

ted variables  and  store  in  SNVAR 
update  SNVARx  (index  to  SNVAR) 

In  case  that  an  illeqal  input  is  encountered  durinq 
the  process  of  the  CRT  inout,  the  display  of  '?'  and  the 
prompt  character  is  initiated  and  orodram  control  is 
returned. 

- determination  of  the  lenqth  of  the  snapshot  instruction 

- insertion  of  the  instruction  in  the  execution  table 
SNExTHL  ( see  structure  of  SNFxTBL  below) 

- insertion  of  the  address  of  the  next  instruction  into 
SNtXTBL  ( = snapshot  address  ♦ instruction  lenqth) 

- insertion  of  RST<4  at  the  snapshot  address 
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At  the  end  of  the  snapshot  'interruDt 1 process#  program  control 
is  transferred  to  the  first  byte  of  the  execution  table 
where 


- the  stack  is  updated 

- interrupts  are  enabled 

- the  replaced  instruction  is  executed 

- program  control  is  transferred  back  to  the  'interrupted' 
program . 

SNAPINT  is  the  Procedure  which  services  the  snapshot  inter- 
rupt. The  return  from  this  procedure  takes  place  as  Described 
above . 

If  the  specified  condition  is  not#  met  control  is  returned. 

If  there  is  already  a snapshot  in  progress#  i.e.  SNAPFL  is 
'THUE'#  a counter  is  incremented  in  order  to  count  multiple 
occurrences  of  the  same  snapshot. 
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If  none  of  the  above  applies,  SNAPFL  is  set  and  the  current 
value  of  the  reauested  parameters  are  saved  if  the  respec- 
tive flag  ( SN V ARx , DUMPF L or  REGFL)  is  set. 

After  saving  of  the  soecified  values  and  scheduling  a 
priority  call  for  procedure  SN AP3H0 T , SNE X T bL  is  executed. 

The  procedure  SNAPSHOT  outputs  the  snapshot  data  to  the  CMT. 
This  is  done  with  'synchronous  output  with  acknowledge'  messaqe 
to  the  CS  modul e . 

The  acknowledge  node  prevents  a possible  overflow  of  the  CMT 
output  buffer. 

The  returned  acknowledge  code  is  used  to  distribute  the  process 
sequentially  through  SNAPSHOT. 

Since  this  process  is  s t r a i qh t f orwa rd * it  is  not  described 
in  detail. 

At  the  end  of  SNAPSHOT  the  flag  SNAPFL  is  reset  to  allow 
the  output  of  the  next  snapshot. 

Procedure  SNAPTERM  has  the  task  of  terminating  the  snapshot 
function.  It  is  called  when  the  'terminate  debug  function' 
message  is  received  or  at  system  start  when  the  system  was 
stopped  before  with  an  activated  snapshot. 

SNAPTERM  restores  the  original  instruction  at  the  snapshot 
address . 


Messaqe  S i mu  I a t i on /E x t r ac t i on 

DBM0D6  consists  of  the  functions  message  simulation  and  message 
extraction.  These  functions  are  handled  in  the  procedures 
ORMSX,  DBMSXINP  and  OBEXTRACT. 

DBMSx  is  the  entry  procedure  for  DBM0D6  and  is  called  from 
the  messaqe  entry  of  the  DB  module. 

If  f 1 aq  DBTELLtJACK  is  'TRUE'  the  procedure  OBEXTRACT  is 
called*  otherwise  DBMSXINP  is  called. 

DBMSX I NP  processes  the  CRT  input  message  for  simulation  and 
ext  rac 1 1 on  . 

In  order  to  obtain  all  necessary  inputs*  the  procedure  initi- 
ates a dialog  with  the  operator  at  the  CRT. 

All  input/outout  is  performed  with  real-time  messages  to  and  from 
the  CS  module. 

In  both  cases*  simulation  and  extraction,  the  dialog  yields  a 
message  control  block. 

Illegal  inputs  are  rejectea  and  prompted  again. 

The  MCB  is  stored  in  DEBUGMCB,  a table  located  in  the  system 
data  area  to  allow  access  by  the  executive  in  order  to  check 
for  messages  to  be  extracted. 

After  completion  of  the  MCH  input*  the  process  splits. 


The  dialog  continues  until  the  incut  of  data  bytes  as 
specified  in  the  MCB  is  completed.  After  this*  the  con- 
structed message  is  sent. 

If  the  messaae  could  not*  be  sent  the  output  of  'MSG  NOT 
SENT ' is  i ssued. 

If  the  sending  of  the  messaae  was  successful  'MSG  SENT'  is 
t yped . 

The  function  terminates  with  the  sending  of  the  prompt 
c harac  ter. 


If  the  last  function  has  oeen  'messaqe  simulation'  and 
the  input  of  RETURN  only  is  received*  the  sending  of  the 
same  message  is  repeated. 

Messaqe  extraction: 

The  extraction  is  initialized  with  the  sending  of  an 
extraction  messaqe  to  the  executive. 

DBEXTRACT  processes  extraction  messages  from  the  executive. 

The  CRT  output  is  done  using  output  with  acknowledge  messages. 
The  process  is  straightforward  and  is  not  described  here. 


Hardcopy 

The  'H'  command  is  processed  in  the  procedure  DBHARDCOPY 
which  is  part  of  DBMUD8. 

If  flag  HARDCOPY  is  'TRUE'  then  it  is  set  to  'FALSE'. 

It  f 1 aq  HARDCOPY  is  'FALSE'  an  'initialize  line  printer'  messaqe 
is  sent  to  the  LP  module  and  HARDCOPY  is  set  to  'TRUE'. 

Before  leavinq  the  procedure*  a new  debug  command  is  prompted. 

In  case  the  line  printer  is  not  connected  to  the  system*  a 
'line  printer  not  connected'  message  will  be  received  by  DB. 

Upon  receipt  of  this  message  the  flag  HARDCOPY  is  set  to  'FALSE'. 

HARDCOPY  controls  the  output  media  in  procedure  DHSYNCPRH. 
Depending  on  the  state  of  hARDCOPY,  the  receiving  module  for 
the  'synchronous  output'  message  is  LP  or  CS. 
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Periodic  Inspect /Duud 

The  inspect  and  dump  functions  can  also  be  executed  as 
periodic  functions#  i.e.  the  output  is  repeated  with  the 
highest  frequency  the  system  allows. 

The  output  of  the  functions  is  sent  to  IP  or  CS  with  acknow- 
ledge request.  Upon  receipt  of  the  acknowledge  message  the  same 
requested  output  is  repeated  with  the  current  contents  of  the 
specified  locations. 


Real-time  Messages 

In  this  section  the  process  of  the  real-time  messages  is 
desc  r i bed . 


3.7.1 


Start 


This  message  is  processed  in  procedure  OBSTART. 

The  following  operations  are  Performed: 

- if  a snapshot  has  been  activated  before  the  last 
system  stop  (DBFUNCIION  = 4)»  then  call  SNAPTERM 
(restore  snapshot  instruction) 

- clear  OB  variable  data 

- clear  snapshot  data 


- set  module  status  (existing  and  activated) 

- determine  start  address  of  procedures  DHINPUT  and 
SNAPSHOT 


- enter  priority  call  for  SNAPSHUT. 
The  OB  module  is  then  ready  to  be  used. 


$.7.2  Input  Text  from  CRT 

This  messaqe  is  processed  hv  the  procedure  OBINPUT  which  consti 
tutes  D6M0D2. 

The  execution  of  DHINPUT  is  controlled  by  a case  statement 
and  the  variable  CRTINPUT. 

CRTINPUT  s 0: 

Input  from  CUT  must  be  the  initiation  of  the  debug  mode. 
'CPTR:  ’ is  typed  on  the  CRT»CRTINPUT  is  set  to  l and  a 
'CRT  input  reduest'  messaae  is  sent  to  CS. 
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CRTINPUT  = 1: 

The  input  of  the  number  of  SBC  which  the  user  wishes  to 
debua  is  expected  now. 

If  the  input  is  not  legal#  then  * ?-CPTR:'  is  tyoert  and  the 
input  request  repeated. 

I 

If  the  number  is  0 or  its  own  SBC  number#  the  procedure 
DBREiJ  is  called  to  initiate  the  debuq  mode. 

In  DBREA  the  control  variable  is  set  to  2 and  a prompt 
for  a debuq  command  is  issued. 

Otherwise  the  number  of  the  debuq  module  in  the  tarqet 
SBC  i s c ompu  t ed . 

If  the  respective  module  is  not  activated#  'DEBUU  MODULE 
NOT  ACTIVATED1  is  tvoeo. 

If  the  module  is  active#  a 'start  debuq  external'  message  is 
• sent  to  the  external  debug  module. 

The  module  number  of  the  own  CS  moaule  is  transmitted  in 
^ the  first  data  byte. 

I 

The  control  variable  is  reset  to  0. 

CRTINPUT  = 2: 

I 

The  input  is  the  selection  of  a debug  function. 

DBINPUT  decodes  the  function  identifier  and  calls  the 
respective  procedure  to  process  the  input. 

The  variable  DBFUNCTION  contains  an  index  which  deter- 
mines the  selected  debug  function. 

CRTINPUT  is  set  to  3. 

CRT  INPUT  = 3: 

This  input  is  caused  by  the  selected  debuq  function  it- 
self. 

Program  control  is  routed  to  the  process  of  the  currently 
activated  function. 


3.7.3  Terminate  I/O 

This  messaqe  informs  the  Dd  module  that  the  connection  to 
the  CRT  has  to  be  terminated  (input  of  'Control-I'  at 
the  CRT ) . 

The  input  control  variable  is  reset  to  0 in  order  to 
accept  a new  i n i t i a l i ? a t i on  of  the  debuq  mode. 

Any  pending  debug  function  and  the  debug  mode  are  ter- 
minated. 
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5.7.4  Start  Debuq 

This  messaqe  informs  DB  that  a 'Control-0'  input  has  been 
made  at  the  CUT. 

This  input  is  processed  in  procedure  DBINPUT  with  control 
variable  CRTINPUI  = 0 (see  Section  3.7.?). 


5.7.5  External  Start  Debuq 

This  message  is  sent  by  a aebua  module  in  an  other  SBC  and  in- 
forms DB  that  there  is  an  external  debug  request  from  an 
other  SBC . 

The  messaae  is  processed  in  procedure  DBEXTREQ. 

After  savinq  the  module  number  of  the  connected  CRT  in  the 
other  SBC  in  DBCRF  procedure#  DBREU  is  called  to  further 
process  the  debuq  request. 


5.7.6  Terminate  Debuq  Function 

This  messaqe  is  received  after  a 'Control-1'  input  at  the  CRT 
and  it  serves  the  purpose  of  terminating  the  currently  acti- 
vated debuq  function. 

The  process  takes  place  in  procedure  DBTERMPER. 

If  no  debug  function  is  activated  (i.e.  the  prompt  character 
is  displayed)#  an  error  messaqe  is  sent  to  CS. 

If  the  activated  function  is  'messaqe  extraction'#  a message  is 
sent  to  EX  to  stop  the  extraction. 

An  activated  snapshot  is  terminated  with  a cal)  of  SNAPTERM. 

After  resetting  of  all  relevant  flaqs#  the  prompt  character  is 
di spl aved. 


3.7.7  Output  Acknowledge 

This  messaqe  is  received  when  an  output  with  acknowledge  initiated 
by  DB  is  comp  1 et  ed . 

The  returned  acknowledge  code  is  saved  in  DPTBCODE  and  the  flag 
DBTELLBACK  is  set  to  'TRUE'. 

Then  DBINPUT  is  called  which  passes  program  control  to  the 
activated  function  controlled  bv  CRT  INPUT  and  DBFUIMCTIDN. 


S.7.8 


txtract ion  Message 


This  messaqe  transmits  an  extracted  message  from  EX  to  the 
'message  extraction'  function  in  DH. 

If  an  extraction  outout  is  currently  active  (DHEXTRACT  = 
'TRUE')  a counter  is  incremented  and  DDEXTRACT  is  not  called. 
Otherwise  OHEXTRACT  is  called  in  order  to  initiate  the  tvoinq 
of  the  extracted  message. 

S . 7 . 9 Line  Printer  not  Connected 

The  orocess  of  this  message  consists  of  resetting  the  f 1 aq 
HARDCOPY  to  'FALSE',  i.e.  outout  is  not  directed  to  the 
line  printer  because  it  is  not  in  operation. 


Output  Real-time  Messaqes 

In  this  section  the  format  of  the  real-time  messaqes  sent  by  OH 
is  describe*!. 


Synchronous  UutPut 


RMN 

Smn  : 
mn  : 

ML  : 

DATAO  : 

DA  T A 1 - 
DATAn  ; 


CS  or  LP 
DB 
I 1 

deoenos  on  lenqth  of  output  text 

0 - no  roll  screen/cr, 1 f after  output 

1 - roll  screen/cr, If  after  output 

text  to  be  t yced/pr i nt ed 


This  messaoe  is  used  to  type  text  on  the  input  line  of  the  CRT 
or  on  the  line  printer. 


CRT  Input  Request 


RMN 

SMN 

MN 

ML 

DATAO 


CS 

Db 

12 

OS 

0 - no  roll  screen  after  input 

1 - roll  screen  after  innut 


This  message  requests  a keyboard  input  from  the  CRT 

Terminate  CRT  Input 


RMN 

: CS 

SMN 

: DB 

MN 

: 14 

ML 

: 04 

This  message  disconnects  DB  from  the  CRT, 

Activate  Debua 


RMN 

: CS 

SMN 

: Db 

MN 

: 15 

ML 

: oa 

This  message  is  used  to  establish  a connection  between  DB  and 
the  CRT  at  which  the  debug  request  was  made. 


- IP  - 


127 


4.7 
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Synchronous  Output  with  Output  Acknowledge 


RMN 

SMN 

MN 

ML 

OAT  AO 
DAT  A 1 


CS  or  LP 
OB 
18 

depends  on  length  of  output  text 
acknowledge  code 

0 - no  roll  screen/cr, 1 f after  output 

1 - roll  screen/cr»1f  after  output 


0ATA2- 

DATAn 


text  to  be  typed/printed 


This  message  is  used  to  type  text  on  the  input  line  of  the  CRT 
or  to  print  on  the  line  printer  and  requests  an  acknowledge 
message  when  the  output  is  completed. 


External  Start  Debug 


- 20  - 
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RMN 

any  external  aebug  module 

SMN 

OB 

MN 

24 

ML 

05 

DAT  AO 

module  number  of  connected  CRT  module 

This  message  informs  an  external  debug  module  about  a debug 

request  from  the  CRT  module  determined  by  DATAO. 

■ 


Start  Message  Extraction 


RMN 

: Ex 

SMN 

: l)B 

MN 

: 10 

ML 

: 04 

This  message  informs  the  executive  that  a message  extraction  is 
started.  The  messaqe  to  be  extracted  is  described  bv  the  MCH 
currently  in  DEBUGMCH. 
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Stoo  Message  Extraction 

RMN 

Ex 

SMN 

OH 

MN 

1 1 

ML 

04 

This  messaqe  causes  the  termination 

the  executive. 

Initialize 

L i ne 

Printer 

RMN 

LP 

SMN 

OB 

MN 

13 

ML 

04 

This  messaqe  is 

sent  when  the  output 

to  the  line  printer. 
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Genera  1 


Int  roiluc  t i on 

The  CRT  module  (moaule  identification:  CS)  is  the  driver  for 
the  CUT  under  the  real-time  operating  system. 

All  I/O  is  interrupt  driven  in  order  to  meet  the  real-time 
r equ i recent s . 

The  CS  module  'connects'  all  other  modules  in  the  system  to 
the  CRT*  i.e.  the  interface  with  the  operator  is  controlled  by 
the  communicating  module.  Ihe  CS  module  merely  passes  data  in 
and  out  for  other  modu I es .t xcept  for  some  line  editing  funct- 
ions CS  does  not  have  its  own  interface. 

The  interface  between  CS  and  a user  module  takes  place  with 
the  use  of  real-time  messages. 

The  module  may  be  shared  by  several  SBC's.  In  this  case  only  the 
messaqe  entry  procedure  ana  the  CS  data  have  to  be  local  to  the 
SBC's. 

Depending  on  the  number  of  the  host  SHC  the  module  numbers  of 
the  CS  module  vary. 

CS  is  designed  to  communicate  with  a DATAMtDIA  Elite  £500  CRT 
and  keyboard. 


Abbreviations  and  Conventions 

All  numbers  in  this  segment  of  text  are  decimal  except  as 
indicated  otherwise. 

SBC  - sinqle  board  computer 

MCB  - message  control  block 
RMN  - receiving  module  number 
SMN  - sending  module  number 
MN  - message  number 
ML  - messaqe  length 

CS  - CHI  module*  module  number  in  SBC  t/£/i  : Oo/l  4/£<? 

EX  - executive*  module  number  in  SBC  l/<?/i  : 00/08/lb 

DB  - debuq  module*  module  number  in  SBC  l/£/5  : 07/15/*?$ 

INACTMUD  - module  number  of  module  currently  connected  to  CRT 
(INput  ACTive  MODule) 

input  line  - last  line  on  CRT 

line  for  asynchronous  outputs  - line  7 on  CRT 

line  for  synchronous  outputs  - last  line  on  CRT  (=input  line) 
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1.3  Facilities  of  the  CS  Module 

’.3.1  1 nput 

the  CS  module  allows  any  module  in  the  system  to  obtain  data 
from  an  operator  at  the  keyboard. 

In  order  to  ease  keyboard  input  » CS  provides  two  line  editing 
func t ions: 

- delete  last  input  character 

- delete  entire  input. 

CRT  input  for  a module  is  initiated  with  an  'activate  CRT 
input'  msq  to  CS.  Ihis  msq  is  acknowledged  with  a msg  sent  back. 
The  first  data  byte  of  this  msg  determines  whether  the  request 
is  acknowledged  or  not. 

Ihe  case  that  CRT  control  is  not  granted  can  only  occur  if 
several  modules  attempt  to  obtain  inputs  at  the  same  time. 

Once  the  connection  to  the  CRT  is  established*  the  user  module 
has  to  send  an  'input  request*  msg  to  CS.  CS  then  sends  the  next 
input  terminated  with  the  RETURN  key  to  the  requesting  module. 

All  keyboard  inputs  are  displayed  on  the  input  line. 

Upon  completion  of  the  inputs*  the  connected  module  has  to  re- 
lease the  CRT  with  a special  msq. 


1.3.2  Output 

There  are  2 distinct  types  of  CRT  output: 

- asynchronous  and 

- synchronous. 

Asynchronous  outputs  are  typed  on  line  7 of  the  CRI. 

The  text  typed  here  is  sent  to  CS  using  the  'asynchronous  out- 
put' msq.  This  msg  may  be  sent  by  any  module  at  any  time  and 
serves  the  Purpose  to  report  errors*  special  internal  conditions 
etc. 

The  output  of  this  messaqe  is  accompanied  by  the  bell. 

For  the  time  of  the  output  all  input  is  blocked  and  a ' T ' is 
displayed  at  the  position  of  the  next  input.  After  typing  the 
asynchronous  messaqe  the  ' T ' is  erased  with  the  next  input. 

Synchronous  outputs  are  typed  on  the  inout  line  and  allow  the 
module  currently  in  control  of  the  CRT  to  interact  with  the 
operator. 

'Synchronous  output’  messages  are  accepted  from  the  connected 
modu I e only. 


a - 


134 


I  

II 

i,  There  are  two  messages  which  control  the  screen  itself.  They 

cause  the  cursor  to  be  positioned  at 


• the  beqinning  of  a new  line  (roll  screen  once) 

• the  beginning  ot  the  current  line. 
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I nput  s 


The  CS  module  receives  inputs  from  the  keyboard  of  the  CRT  and 
from  other  modules  with  real-time  messaqes. 

2 . I Input  f rom  CRT 

Keyboard  inputs  are  transmitted  in  form  of  ASCII  characters. 

See  DAT  AMtD  I A tlite  <?B00  manual  for  details. 

Apart  from  the  normal  character  set  there  are  inputs  which  have 
soecia)  meanings.  They  are  listed  below: 

•Control-I*  - CRT  interruption 

This  input  forces  the  termination  of  any 
existing  connection  between  a module  and 
the  CRT. 

•Control-D'  - enter  debug  moae 

'Control-T'  - terminate  debug  function 

'Back  Space'  - delete  last  character 

'Rub  Out'  - delete  entire  input 

'CR'  - termination  of  current  input 

The  interpretation  of  these  inputs  is  described  in  Section  1.2. 


2.2  Input  Real-time  Messages 

In  this  section  the  format  of  the  incoming  real-time  messaqes  is 
given.  The  process  of  these  messages  is  described  in  Section  3.4. 


2. 2.1  Start 


RMN 

: cs 

SMN 

: tx 

MN 

: oo 

ML 

: 04 

This  msq  is  sent  by  the  executive  when  the  system  is  started. 
Upon  receipt  the  CS  module  initializes  itself 
(see  Section  3.4.1). 
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2,2.2  Asynchronous  Output 


RMN 

SMN 

MN 

ML 

DATAO- 
l)  A T An 


CS 

any  modu 1 e 

to 

depenas  on  length  of  text 
text  to  be  typed 


This  message  is  received  when  a module  is  initiating  an 
asynchronous  output  (see  Section  3.  4.2). 


2.2. 3 


Synchronous  UutPut 


RMN 

SMN 

MN 

ML 

DAT  AO 

D A T A 1 ■ 
DATAn 


CS 

module  currently  connected  to  CRT  (INACTMUD) 
1 1 

depends  on  length  of  text 

0 - no  roll  screen  after  output 

1 - roll  screen  after  output 

text  to  be  typed 


The  module  currently  connected  to  the  CRT  transmits  text  to  be 
typed  on  the  input  line  with  this  message  (see  Section  3.4.3). 


.2.4 

CRT  Input 

Reguest 

RMN 

: cs 

SMN 

: INACTMOD 

MN 

: 12 

ML 

: os 

DAT  AO 

; 0 - no  r 

this  message  is  sent  by  the  module  currently  connected  to  the 
CRT  to  reguest  an  input  from  the  keyboard  (see  Section  3.4.4), 


2.2.S  Activate  CRT  Input 


RMN 

SMN 

MN 

ML 


CS 

module  reguesting  connection  to  the  CRT 
13 

04 


With  this  message  each  module  can  establish  a connection  to 
the  CRT  (see  Section  3.4.S). 
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2.2.t>  Terminate  CUT  Inpot 


RMN 

SM.Vi 

MN 

ML 


CS 

inactmod 

14 

ou 


This  message  is  used  by  the 
CRT  to  release  the  CUT  (see 


module  currently  connected  to  the 
Sec  t ion  3 . 4 . b ) . 


2.2*7  Activate  Debug 


RMN 

SMN 

MN 

ML 


CS 

any 

15 

04 


debug  modu 1 e 


With  this  message  the  user  selected  debug  module  connects 
itself  to  the  CRT  (see  Sect  ion. 4. 7). 


2.2. 8 New  L i ne 


RMN 

: CS 

SMN 

; INACTMOD 

MN 

: lb 

ML 

: 04 

This  message  causes  the  roll  of  the  screen  by  1 line  and  the 
positioning  of  the  cursor  at  the  beginning  of  a new  line 
(see  Section  3.4.8). 


2.2.V  Begin  of  Line 


RMN 

: CS 

SMN 

J INACTMOD 

MN 

: 17 

ML 

: 04 

This  message  positions  the  cursor  at  the  beginning  of  the  current 
input  line  (see  Section  3.4.9), 
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£.2.10  Synchronous  Output  with  Acknowledge 


RMN 

SMN 

MN 

ML 

OAT  AO 
0 A T A 1 

DATA2- 
0 A T An 


CS 

IMAC IMOD 
18 

depends  on  length  of  text 
acknowledge  code 

0 -•  no  roll  screen  after  output 

1 - roll  screen  once  after  output 

text  to  be  typed 


This  message  initiates  a synchronous  output  on  the  input  line 
and  requests  an  acknowledge  message  when  this  output  is  com- 
pleted (see  Section  3.4.10). 


3 - 1 • T-T 


s 


3.1 


Process  i no 


In  this  section  the  Drocess  of  CRT  inout/output  and  real-time 
messaqe  is  described. 

US AH  T I n t e r ♦ ac  e 

Ihe  operation  of  the  USARI  is  controlled  by  a mode  control 
word  and  a command  control  word. 

After  a hardware  reset/  the  first  output  has  to  be  a mode 
control  word.  After  having  received  the  mode  control  word 
the  USARI  accepts  any  numoer  of  command  control  words. 

If  it  is  required  to  output  a mode  control  word  without  a 
hardware  reset#  the  USARI  can  be  reset  with  a special  con- 
trol word. 


Ihe  formats  of  the  control  words  and  the  input/output  ports 
are  given  below. 

Mode  Control  word: 


bit  7 # b : 01 

" 5,  4 : 00 

- 3#  2 : 10 

" l#  o : 10 


1 STOP  BIT 
NO  PARITY 

7 BIT  CHARACTER  LENUlH 
BAUD  RATE  FACTOR  lb 


Command  Control  word: 


b i t 7 : 0 

M b : 0 

- 5 : l 

" a : o 

H 3 : 0 

M 2 : 1 

" 1 : 1 

" 0 : 1 


NO  RESET 
RESET  USART 
REQUEST  TO  SEND 


RECEIVE  ENABLE 
DATA  TERMINAL  READY 
transmit  enable 


Input/Output  Port  tor  status  information  is  0EEH,  for  data 
0F.EH. 


to 
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1 nput  f ro*  CRT 


All  CRT  input  is  interrupt  driven. 

Upon  svstem  start#  the  USART  (CRT  input)  is  initialized  and  the 
respective  interrupt  is  activated. 

If  a key  on  the  keyboard  is  hit,  an  interrupt  occurs.  The  inter- 
rupt procedure  decodes  the  interrupt  and  schedules  a call  of  the 
the  priority  procedure  CSINPUT.. 

After  the  call  of  CSINRUT  by  the  executive#  an  input  instruction 
is  executed  to  obtain  the  input  character. 

Without  any  filtering  the  following  inputs  are  considered  in  the 
the  indicated  sequence  and  processed: 

- 'Control-1'  : CRT  interruption 

- 'Control-D'  : initialize  debua  mode 

- 'Control-1'  : terminate  debug  function 
' Con t ro 1 - I ' : 

This  input  forces  the  termination  of  the  current  connection 
between  a module  and  the  CRT. 

If  a module  is  currently  connected  to  the  CRT 

(INACTMOD  <>  FFH),  then  a 'terminate  I/O'  msg  is  sent  to  this 
modu  1 e . 

If  no  module  is  connected#  no  actions  take  place. 

' Con t ro 1 -0 ' : , 

This  inout  initiates  the  debug  mode. 

If  debuqging  from  this  CRT  is  already  activated#  the  error 
indication  '?'  is  written  into  the  output  buffer. 

If  the  request  is  legal#  any  current  connection  between  a 
module  and  the  CRT  is  terminated  with  the  'terminate  I/O’ 
message  and  a 'start  debug’  message  is  sent  to  the  debug 
module  in  the  same  SBC. 

’ Cont  rol -1  ' : 

This  input  causes  the  sendinq  of  a 'terminate  debug  func- 
tion msg  to  the  connected  debuq  module.  If  not  in  debug 
mode#  a '?'  is  written  into  the  output  buffer. 

All  other  keyboard  inputs  are  considered  only  if 

- no  output  is  active 

- an  'input  request'  msg  has  been  received. 
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'Back  Space' 
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This  input  causes  the  aelet ion  of  the  last  input  character 
on  the  screen  and  in  the  input  Buffer. 

The  cursor  is  moved  back  and  the  last  input  is  erased. 

An  attempt  to  move  the  Cursor  past  the  beoinninq  of  the  last 
input  reauest  is  not  accented  and  answered  with  the  bell. 

' Hub  Out ' : 

With  this  key  the  entire  input  of  the  last  input  request  ccn 
be  erased.  The  cursor  is  moved  back  to  the  first  position  of 
the  last  input  request  and  the  rest  of  the  line  is  deleted 
so  that  a correct  input  line  can  be  qencrated. 

• HE.  T UHN ' : 

This  kev  terminates  the  current  input. 

The  input  collected  start  inq  at  the  position  of  the  cursor 
at  the  last  input  request  is  sent  to  the  connected  module 
with  a 'transfer  input  text'  messaqe. 

Dependinq  on  the  specification  in  the  last  'input  request' 
messaqe*  the  screen  is  rolled  once  or  not. 

All  other  i npu  t s : 

The  inout  ASCII  character  is  checked  for  leqality.  Lena! 
codes  have  to  be  within  the  ranqe  of  1 f-  H < input  code  < 5AH 
and  within  the  length  of  the  input  line. 

If  the  input  is  illegal  a '?'  is  written  into  the  output 
buffer*  otherwise  the  input  is  stored*  the  inout  buffer 
pointers  are  updated  and  the  input  character  is  written 
into  the  output  buffer. 

Before  returning  program  control  to  the  executive*  the  output 
of  the  current  output  buffer  contents  is  initiated. 
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UutPut  to  CHI 
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AH  CHT  output  is  interrupt  driven. 

At  system  start  the  following  codes  are  written  into  the 
output  buffer: 

- clear  screen 

- set  roll  mode 

• output  •***  SYSTEM  START'  and  bell  on  the  line  for 
asynchronous  outputs 

• position  cursor  at  the  beginning  of  input  line. 

Then  the  output  is  activated  by  executing  an  output  instruction 
for  the  first  character  in  the  output  buffer. 

Upon  completion  of  the  output*  an  interrupt  occurs  which  is 
processed  by  the  interrupt  routine.  After  determining  the  source 
of  the  interrupt*  a priority  call  of  CSOUTPUT  is  scheduled. 

If  there  are  no  more  characters  for  output*  the  output  buffer 
pointers  are  reset  to  0 ana  an  acknowledge  message  is  sent  to 
INACTMOD  if  reguested. 

Otherwise  the  next  character  from  the  output  buffer  is  trans- 
ferred to  the  USAHI  and  the  buffer  pointers  are  updated. 

The  output  buffer  CHTOUT  has  <?  pointers: 

- OUTPTH  (next  character  for  output) 

- OUTX  (next  character  to  fill). 

CRTOUT  is  empty  if  OUTPTH  >=  OUTX.  In  this  case  both  pointers 
are  reset  to  0. 
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Weal-time  Messages 


Start 

This  message  informs  CS  that  thp  system  has  been  started. 

CS  Performs  the  following  initials  a tion  steps: 

- reset  USAWT  if  no  system  reset  has  been  performed 

- clear  all  local  variable  data 

- determine  begin  addresses  of  priority  procedures  CSINPUT 
and  CSOUTPUT  and  store  in  CSINADW  and  CSUUTADW 
respectively 

- set  module  status: 

. modu 1 e exists 
. modu I e activated 

. module  authoritec  to  suspend/ ac t 1 va t e other  modules 

- reset  pointers  and  f I aas 

- enter  priority  calls  of  CSINPUI  and  CS0UIPU1 

- initialize  USAWT 

- pack  'start  output’  into  output  buffer 

- initialize  output  to  USAWT 


Asynchronous  Output 

With  this  messages  text  to  be  typed  on  the  line  tor  asynchronous 
outputs  (line  7 on  CWT)  is  sent  to  CS. 

For  the  duration  of  the  output,  an  uparrow  (’*')  is  displayed 
at  the  Current  position  of  the  cursor  on  the  inout  line. 

After  completion  of  the  asynchronous  output,  the  cursor  is 
returned  to  its  last  position  on  the  input  line.  The  next 
keyboard  input  erases  the  * t * . 


the  following  output  is  initiated: 

- • t • 

- move  cursor  to  the  beqinninq  of  line  7 

- clear  line 

- pac  k hell 

- pac  k ' * * * ' 

- pack  output  text  (from  message) 

- pack  code  to  return  cursor  to  the  last  input  position. 

After  packing  the  output  buffer#  the  output  is  initiated  with 
the  call  of  STARTUUT. 


Synchronous  Output 

This  message  causes  the  tvrinq  of  the  transferred  text  on  the 
i nput  line. 

If  SMN  of  this  message  cifferent  from  INACTMOU#  then  the 

system  routine  ILLEG*  is  called  and  the  messaqe  rejected. 

If  the  message  is  legal*  the  text  of  the  message  startinq  at 
data  byte  1 is  moved  into  the  output  buffer. 

If  data  byte  0 is  TRUE#  then  the  roll  of  the  screen  after  the 
output  is  requested  and  the  respective  characters  are  entered 
into  the  output  buffer. 

If  no  roll  is  requested*  the  Position  of  the  cursor  on  the  input 
line  is  incremented  Dy  the  number  of  characters  in  the  trans- 
ferred text  . 

The  output  to  the  CRT  is  initiated  with  a call  of  procedure 
START0U1 . 


CRT  Input  Request 

This  messaqe  requests  an  incut  from  the  CRI  keyboard. 

It  SMN  is  not  INACTMOO,  then  the  system  routine  ILLEGALMSG  is 
called  and  the  request  is  rejected. 

The  cursor  position  and  the  input  buffer  pointer  are  saved  in 
order  to  mark  the  beginning  of  this  input  for  line  editing. 

The  variable  ROLLSCRtfcN  is  set  according  to  data  byte  0 of  the 
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5.4.5  Activate  CRT  Input 


5.4.6 


This  message  is  sent  ny  a module  which  wishes  to  establish  a 
connection  to  the  CRT. 


This  request  is  answered  with  an  acknowledge  message  in  which 
the  first  data  byte  indicates  whether  the  request  is  acknowledged 
or  not. 


SMN  of  this  message  is  saved  in  the  variable  INACTMQD. 


Terminate  CRT  Input 


This  message  terminates  the  connection  between  the  sending 
module  (SMN  = INACTMGD)  ana  the  CRT. 

CS  resets  I N ACT^OD  to  FFH . 


5.4.7  Activate  Debug 


This  message  connects  a debug  module  to  the  CRT.  No  acknowledge 
messaqe  is  sent  in  this  case  since  this  request  is  always 
granted. 

INACTMOD  is  set  to  the  module  number  of  the  debug  module. 


5.4.8  New  Line 


This  message  is 
messaqe  and  the 


internally  converted  to  a ‘synchronous  output' 
procedure  for  synchronous  output  is  called. 


5.4.9  Beginning  of  Line 
See  Sec  t i on  3.4.8 


3.4.10  Synchronous  Output  with  Acknowledge 

The  process  of  this  messaqe  is  essentially  identical  to  the 
process  of  a synchronous  message  without  acknowledge 
(see  Section  3.4.3)  with  the  exception  that  the  sending  module 
requests  a message  to  indicate  the  completion  of  the  initiated 
output • 

This  feature  can  be  used  to  avoid  overwriting  of  text  and 
buf  fer  overf 1 ows. 

The  first  data  byte  contains  the  acknowledge  code  which  has  to 
be  returned  with  an  acknowledge  messaqe  after  completion  of 
the  output . 


Outout  s 


The  CS  module  outputs  data  to  the  CRT  and  sends  real-time 
messaqes  to  other  modules  in  the  system. 

Output  to  CRT 

Outputs  to  the  CRT  are  transmitted  in  form  of  ASCII  characters. 
See  DATAMEDIA  Elite  <2500  manual  for  details. 

The  only  ASCII  exception  is  the  use  of  the  XY  addressing 
feature  of  the  DATAMEDIA. 

This  mode  allows  the  arbitrary  positioning  of  the  cursor. 

The  XY  mode  is  initiated  with  'OCH'.  The  following  two  characters 
(coded  according  to  the  manual)  are  considered  to  be  a location 
on  the  CRT.  The  first  determines  the  position  in  a row  and  the 
second  character  determines  the  row. 

If  CS  detects  an  illegal  input  character,  then  this  is  indicated 
with  the  output  of  '?'. 


Real-time  Messages 

In  this  section  the  format  of  the  real-time  msq  sent  by  CS  is 
desc  r i bed . 

Transfer  Input  Text 

RMN  I INACTMOD 

SMN  : CS 

MN  : 20 

ML  : depends  on  length  of  input  text 
DAT A0- 

D A T An  : i npu t text 

This  message  is  used  to  send  input  text  to  the  requesting 
modu 1 e . 

Activate  CRT  Inout  Acknowledge 

RMN  : INACTMOD 

SMN  : CS 

MN  : <?1 

ML  : 05 

DATAO  : TRUE  - request  acknowledged 
FALSE  - otherwise 

This  message  informs  the  module  which  wants  to  activate  CRT 
input  whether  the  request  is  granted  or  not. 


4.2.3  Terminate  I/O 


4.2.5 


* 

RMN 

INACTMOO 

SMN 

CS 

1 J * 

MN 

22 

ML 

04 

This  message 

is  sent 

[ 

the  CRT  when 

the  CRT 

«.2.a 

\ 

Start  Debuc 

1 

i 

RMN 

DB 

SMN 

CS 

MN 

23 

1 

ML 

04 

This  msg  informs  the  debug  module  that  the  legal  input 
•Control-D'  has  been  generated. 


4.2.5  Terminate  Debug  Function 


RMN 

; OB 

SMN 

: CS 

MN 

: 25 

ML 

: 04 

This  message  informs  the  debug  module  that  the  input  of 
' Con t ro 1 - T * has  been  detected. 


Acknow 1 edge 


RMN 

; INACTMOO 

SMN 

: CS 

MN 

: 2o 

ML 

: 05 

DA  T AO 

: acknowledge  code 

This  message  indicates  the  completion  of  an  output  with 
acknowledge  reguest. 

The  acknowledge  code  is  identical  to  the  code  received  with  the 
•synchronous  output  with  acknowledge'  message. 
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Genera  I 
I nt  roduc  t i on 

The  Tine  printer  module  (LP)  is  the  oriver  tor  the  CE  NTRGMX  101 
line  orinter  under  the  real-time  operat ina  system. 

All  outout  is  interrupt  driven  in  order  to  meet  the  real-time 
requ i rement s . 

The  code  of  t he  LP  module  may  tie  shared  by  several  single 
board  comouters  it  more  than  1 line  printer  is  to  be  connected 
to  the  system. 

All  modules  in  the  system  can  initiate  printouts  on  the  line 
printer  bv  transferring  text  to  LP  with  a real-time  message. 


Abbrev i at i ons  and  Conventions 

All  numbers  in  this  segment  of  text  are  decimal  except  when 
indicated  otherwise. 


SBC  - sinqle  board  computer 

MCB  - message  control  block 
RMN  - receiving  module  number 
SMN  • sending  module  number 
MN  - message  number 
ML  - messaae  lenqth 

CS  - CRT  module#  module  number  in  SBC  1/2/5  : 06/1*4/22 

EX  - executive#  module  number  in  SBC  1/2/5  : 00/06/lb 

DB  - debug  module#  module  number  in  SRC  1/2/5  : 07/15/25 

LP  - line  orinter  module#  module  number  in  SBC  1/2/5  : 05/15/21 
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Facilities  of  the  LP  Module 

In  order  to  allow  the  switching  of  output  between  CRT  and 
line  printer,  the  usaae  of  the  line  printer  is  very  similar 
to  the  CK1  output,  i.e.  is  controlled  by  the  same  messages. 
(Exception:  the  'beninning  of  line'  message  is  interpreted  as 
•new  line*  message.) 

LP  allows  to  print  any  text  sent  to  the  module  with  the 
•print*  message.  The  text  is  transferred  in  the  data  bytes  of 
the  message  and  has  to  be  ASCII  coded. 

This  text  can  be  printed  with  or  without  the  generation  of 
a acknowledge  msg  to  indicate  the  completion  of  the  orintout. 

Apart  from  the  'print'  and  'print  with  acknowledge'  message 
there  are  3 form  control  message: 

- new  page 

- new  line 

- beginning  of  line  (interpreted  as  new  line). 

LP  accepts  an  'initialize  line  printer'  message.  Upon  receipt 
of  this  message  the  proper  connection  of  the  line  printer  is 
checked. 

It  the  check  is  positive,  the  print  head  is  positioned  at  the 
beginning  of  a new  page. 

Otherwise  a warning  message  is  typed  on  the  CRT  and  a 'line 
printer  not  connected*  message  is  sent  to  the  module  which  re- 
guested the  check. 


Input  s 

The  LP  module  receives  inputs  from 

- line  printer  (status  inputs) 

- other  modules  (real-time  messages). 

Status  Inputs  from  Line  Printer 

Two  status  bits  from  the  line  printer  are  made  available 
for  LP  on  input  port  tb: 

- bit  a : ' StLEC  T ' 

-bit  3 : 'LPT  HUST  ’ . 

- a - 
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Input  Weal-time  Messaoes 

In  this  section  the  format  of  the  incominq  real-time  messaqe  is 
qiven. 

The  Process  of  these  messages  is  described  in  Section  3.4. 


Start 


This  messaqe  is  sent  by  the  executive  when  the  system  has  been 
started. 

Upon  receipt  the  LP  module  initializes  itself 
( see  Sec  t i on  3.4.1). 


2.2.2 


Print 


2.2.4 


rmn 

SMN 

MN 

ML 

DAT  AO 

DATAl- 
DA  T An 


LP 

any  module 

1 t 

depends  on  lenqth  of  text  to  be  printed 

0 - no  new  line  after  output 

1 - new  line  after  output 

ASCII  characters  to  be  printed 


The  text  transferred  with  this  messaqe  is  to  be  printed  on  the 
line  printer  (see  Section  3.4.2). 


2.2.3  New  Page 


RMN 

: LP 

SMN 

: any  »odu 1 e 

* 

MN 

: 12 

ml 

: 04 

This  message  requests  the  cositioninq  of  the  print  head  at 

the  beginning  of  the  first  line  on  a new  paqe  (see  Section  3.4.3) 


Initialize  Line  Printer 


RMN  : 

LP 

SMN  : 

any  module 

mn  : 

13 

ML  : 

04 

messaqe 

causes  LP 

Sec  t i on 

3.4.4)  . 

5 


. 


2.2.5 


L i ne 

RMN 

LP 

SMN 

any  module 

MN 

16 

ML 

04 

This  messaqe  Positions  the  print  head  at  the  beqinninq  of  a 
new  line  (see  Section  5.4.5). 


2.2.6  Beqinninq  of  Line 


RMN 

: LP 

SMN 

: any  module 

MN 

: 17 

ML 

: 04 

This  messaqe  is  processed  as  beinq  a 'new  line’  msg 
(see  Section  2.2.5). 


2.2.7  Print  with  Acknowledge 

RMN  : LP 

SMN  : any  modu 1 e 

MN  : 18 

ML  : depends  on  lenqth  of  text 

DATAO  : acknowledge  cede 
0ATA1  : 0 - no  new  line  after  print 

1 - new  line  after  print 

DATA2- 

DATAn  : ASCII  characters  to  be  printed 

The  transferred  text  of  this  message  is  to  be  printed  and  upon 
completion  of  the  printing  an  acknowledge  messaqe  with  DATAO 
has  to  be  returned  to  the  sending  module  (see  Section  3.4.6). 


- 6 - 


5 Hrocessinq 

.1  Line  Printer  Interface 


5.2  Line  Printer  Status  Input 

Upon  receipt  of  the  'initialize  line  printer'  messaoe/  LP  reads 
the  'SELfcCT'  status  bit  of  the  line  printer. 

If  the  line  printer  is  connected  ('SELtCf'  bit  = 'FALSE') 
the  procedure  LPNtwPAGfc  is  called. 

If  the  line  printer  is  not  connected  properly: 

- an  'asynchronous  output'  msq  is  sent  to  LS  to  type  a 
warning  '***  LINE  PKINTEK  NOT  CONNECTED' 

- a 'line  printer  not  connected'  usq  is  sent  to  the  module 
which  sent  the  'initialize  line  printer'  msq. 


5.3  Line  Printer  Output 

All  line  printer  output  is  interrupt  driven. 

The  output  characters  are  written  into  the  output  buffer 
LPOUTBUF.  LPOUTBUF  is  controlled  by  two  pointers: 

- LPOUTX  (next  to  fill) 

- LPOUTPTR  (next  to  print). 

LPUUTBUF  is  empty  if  LPOUfPTP  >=  LPOUTX.  In  this  case  both 
pointers  are  reset  to  0. 

An  overflow  occurs  if  LPOUTX  > last  index  of  LPOUTBUF.  This 
condition  causes  a call  of  the  system  monitor  ana  output 
characters  are  rejected  until  there  is  space  in  LPOUTBUF, 

When  all  text  is  transferred  from  the  'print'  message  into  the 
output  buffer,  or  an  overflow  occurs,  the  output  is  started  by 
calling  the  output  procedure. 

When  the  output  of  a character  is  completed,  an  interrupt  is 
qenerated  and  the  priority  call  of  the  procedure  LPUUlPUT  is 
scheduled  by  the  interrupt  procedure. 

After  LPOUTPUT  called  by  the  executive,  the  next  character  is 
is  put  on  the  output  line  or  the  printout  is  terminated 
(if  LPOUTBUF  is  empty). 

In  the  latter  case  the  flag  LPTELLBACK  is  checked  and  an  ack- 
nowledge messaae  is  generated  if  necessary. 
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mm 


Weal-time  Messages 
Start 

This  message  informs  LP  that  the  system  has  heen  started. 

IP  Performs  the  followinq  operations: 

- clear  all  local  variables 

- determine  start  address  of  Procedure  LPOUTPUT 

- enter  priority  call  for  LPUUTPUT 

(to  be  called  if  a line  printer  outout  interrupt  occurs) 

- set  module  status 

. modul e exists 
. module  activated. 


Print 

This  message  is  processed  in  procedure  LPPHINT. 

The  data  bytes  of  the  msg  are  moved  into  the  output  buffer  until 
all  characters  are  moved  or  an  overflow  occurs. 

In  case  of  an  overflow,  the  move  of  characters  is  terminated 
and  the  output  is  initiateo. 

When  the  remaining  space  is  sufficient  and  all  characters  are 
moved,  then  DATAO  of  the  msg  controls  the  insertion  of  code  for 
a 'carriage  return'  and  a 'line  feed'.  Then  the  output  is  initi- 
ated. 


New  Page 

The  code  for  'form  feed'  is  packed  into  the  output  buffer  and 
the  output  is  activated. 


Initialize  Line  Printer 

LP  reads  the  'SELECT'  status  bit  and  determines  whether  out- 
put is  possible  or  not. 

If  no  printing  is  possible,  i.e.  the  printer  is  not  connected 
properly,  the  typing  of  a warning  message  at  the  CRT  is  generated 
with  an  ‘asynchronous  output'  msg  to  CS. 

Otherwise,  the  'new  page'  procedure  is  executed 
( see  Sec  t i on  3.4.3). 


New  Line 

The  code  for  'carriage  return'  and  'line  feed'  is  packed  into 
the  output  buffer  and  the  output  is  activated. 


5.4.6  Print  with  Acknowledge 

This  message  is  processed  fcv  the  procedure  LPPKINT  (see  5.4.2) 
after  the  acknowledge  code  has  been  removed  from  the  msq. 

The  code  and  the  sending  module  is  saved. 

After  completion  of  the  output  an  acknowledge  messaqe  is  sent 
back  together  with  the  requested  acknowledge  code. 


t 

1! 


4.1 


4.2 

4.2.1 


4.2.3 


UutPuts 


The  LP  module  outputs  data  to  the  line  printer  and  sends 
messaqes  to  other  modules  in  the  system. 


Output  to  the  Line  Printer 


Cutouts  to  the  line  printer  are  transmitted  in  form  of  ASCII 
charac  ters . 

Letters  are  printed  as  capital  letters  only. 


See  the  available  CENTRONIX  101  interface  specification. 
Output  port  is  port  E4H. 


Real-time  Messages 


Asynchronous  Output 


RMN  : 

CS 

SMN  : 

LP 

mn  : 

10 

ML  : 

30 

DATA0- 

DATA25: 

text 

text  'LINE  PRINTER  NOT  CONNtCrEO' 


4.2.2  Acknowledge 


RMN 

module  which  sent  ’print  with 

acknowledge'  message 

SMN 

LP 

MN 

2b 

ML 

OS 

OAT  AO 

acknowledge  cede  transferred 

with 

'print  with 

acknowledge*  message 

Printer  not  Connected 

RMN 

module  which  sent  ’initialize 

line 

printer'  message 

SMN 

LP 

MN 

28 

ML 

04 

message  informs  the  requesting  module 

that 

the  line  printer 

is  not  connected  properly  to  the  system. 
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